XML シリアル化を制御する属性
次の表に示す属性をクラスおよびクラス メンバに適用すると、XmlSerializer がそのクラスのインスタンスをシリアル化または逆シリアル化する方法を制御できます。これらの属性で XML シリアル化を制御する方法については、「属性を使用した XML シリアル化の制御」を参照してください。
また、これらの属性を使用して、XML Web サービスによって生成されるリテラル スタイルの SOAP メッセージを制御することもできます。これらの属性を XML Web サービス メソッドに適用する方法の詳細については、「XML Web サービスを使用した XML シリアル化」を参照してください。
属性の詳細については、「属性を使用したメタデータの拡張」を参照してください。
| 属性 | 適用対象 | 機能 |
|---|---|---|
XmlAttribute オブジェクトの配列を返すパブリックなフィールド、プロパティ、パラメータ、または戻り値 |
逆シリアル化時に、スキーマで未定義のすべての XML 属性を表す XmlAttribute オブジェクトを配列に挿入します。 |
|
XmlElement オブジェクトの配列を返すパブリックなフィールド、プロパティ、パラメータ、または戻り値 |
逆シリアル化時に、スキーマで未定義のすべての XML 要素を表す XmlElement オブジェクトを配列に挿入します。 |
|
複合オブジェクトの配列を返すパブリックなフィールド、プロパティ、パラメータ、または戻り値 |
配列のメンバを XML 配列のメンバとして生成します。 |
|
複合オブジェクトの配列を返すパブリックなフィールド、プロパティ、パラメータ、または戻り値 |
配列に挿入できる派生型を指定します。通常、XmlArrayAttribute と共に適用されます。 |
|
パブリックなフィールド、プロパティ、パラメータ、または戻り値 |
メンバを XML 属性としてシリアル化します。 |
|
パブリックなフィールド、プロパティ、パラメータ、または戻り値 |
列挙体を使用して、メンバを明確に区別できるようにします。 |
|
パブリックなフィールド、プロパティ、パラメータ、または戻り値 |
フィールドまたはプロパティを XML 要素としてシリアル化します。 |
|
列挙体識別子であるパブリック フィールド |
列挙体メンバの要素名を指定します。 |
|
パブリック プロパティおよびパブリック フィールド |
クラスのシリアル化時に、そのクラスに含まれているプロパティまたはフィールドを無視します。 |
|
パブリック派生クラス宣言、およびパブリック メソッドの戻り値 (Web サービス記述言語 (WSDL : Web Service Description Language) ドキュメント用) |
シリアル化されたときにクラスが認識されるように、スキーマの生成時にそのクラスを対象に含めます。 |
|
パブリック クラス宣言 |
XML ルート要素としての属性ターゲットの XML シリアル化を制御します。この属性を使用して、さらに名前空間と要素名を指定できます。 |
|
パブリック プロパティおよびパブリック フィールド |
プロパティまたはフィールドを XML テキストとしてシリアル化します。 |
|
パブリック クラス宣言 |
XML 型の名前および名前空間を指定します。 |
System.Xml.Serialization 名前空間にあるこれらの属性の他に、System.ComponentModel.DefaultValueAttribute 属性もフィールドに適用できます。DefaultValueAttribute は、メンバの値が指定されていない場合に、メンバに自動的に割り当てられる値を設定します。
エンコード済みの SOAP XML シリアル化を制御する方法については、「エンコード済み SOAP シリアル化を制御する属性」を参照してください。
参照
処理手順
方法 : XML ストリームの代替要素名を指定する
方法 : オブジェクトをシリアル化する
方法 : オブジェクトを逆シリアル化する