次の表の属性をクラスとクラス メンバーに適用して、 XmlSerializer がクラスのインスタンスをシリアル化または逆シリアル化する方法を制御できます。 これらの属性が XML シリアル化を制御する方法については、「 属性を使用した XML シリアル化の制御」を参照してください。
これらの属性を使用して、XML Web サービスによって生成されるリテラル スタイルの SOAP メッセージを制御することもできます。 これらの属性を XML Web サービス メソッドに適用する方法の詳細については、「XML Web サービスを使用した XML シリアル化」を参照してください。
属性の詳細については、「 属性」を参照してください。
特性 | 対象 | 指定内容 |
---|---|---|
XmlAnyAttributeAttribute | オブジェクトの配列を返すパブリック フィールド、プロパティ、パラメーター、または戻り値 XmlAttribute 。 | 逆シリアル化すると、スキーマに不明なすべての XML 属性を表す XmlAttribute オブジェクトが配列に格納されます。 |
XmlAnyElementAttribute | オブジェクトの配列を返すパブリック フィールド、プロパティ、パラメーター、または戻り値 XmlElement 。 | 逆シリアル化すると、スキーマに不明なすべての XML 要素を表す XmlElement オブジェクトが配列に格納されます。 |
XmlArrayAttribute | 複合オブジェクトの配列を返すパブリック フィールド、プロパティ、パラメーター、または戻り値。 | 配列のメンバーは、XML 配列のメンバーとして生成されます。 |
XmlArrayItemAttribute | 複合オブジェクトの配列を返すパブリック フィールド、プロパティ、パラメーター、または戻り値。 | 配列に挿入できる派生型。 通常、 XmlArrayAttributeと組み合わせて適用されます。 |
XmlAttributeAttribute | パブリック フィールド、プロパティ、パラメーター、または戻り値。 | メンバーは XML 属性としてシリアル化されます。 |
XmlChoiceIdentifierAttribute | パブリック フィールド、プロパティ、パラメーター、または戻り値。 | 列挙型を使用することで、このメンバーのあいまいさをより一層解消することができます。 |
XmlElementAttribute | パブリック フィールド、プロパティ、パラメーター、または戻り値。 | フィールドまたはプロパティは XML 要素としてシリアル化されます。 |
XmlEnumAttribute | 列挙識別子であるパブリック フィールド。 | 列挙メンバーの要素名。 |
XmlIgnoreAttribute | パブリック プロパティとフィールド。 | 包含クラスをシリアル化する場合、プロパティまたはフィールドは無視する必要があります。 |
XmlIncludeAttribute | Web サービス記述言語 (WSDL) ドキュメントのパブリック派生クラス宣言とパブリック メソッドの戻り値。 | このクラスは、スキーマを生成するときに含める必要があります (シリアル化時に認識されます)。 |
XmlRootAttribute | 公開クラス宣言。 | 属性ターゲットの XML シリアル化を XML ルート要素として制御します。 属性を使用して、名前空間と要素名をさらに指定します。 |
XmlTextAttribute | パブリック プロパティとフィールド。 | プロパティまたはフィールドは XML テキストとしてシリアル化する必要があります。 |
XmlTypeAttribute | 公開クラス宣言。 | XML 型の名前と名前空間。 |
ObsoleteAttribute | パブリック プロパティとフィールド。 | 包含クラスがシリアル化されるときに、プロパティまたはフィールドは無視されます。 |
System.Xml.Serialization名前空間にあるこれらの属性に加えて、DefaultValueAttribute属性をフィールドに適用することもできます。 DefaultValueAttribute は、値が指定されていない場合にメンバーに自動的に割り当てられる値を設定します。
エンコードされた SOAP XML シリアル化を制御するには、「 エンコードされた SOAP シリアル化を制御する属性」を参照してください。
こちらも参照ください
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET