次の方法で共有


XML シリアル化を制御する属性

次の表に示す属性をクラスおよびクラス メンバに適用すると、XmlSerializer がそのクラスのインスタンスをシリアル化または逆シリアル化する方法を制御できます。これらの属性で XML シリアル化を制御する方法については、「属性を使用した XML シリアル化の制御」を参照してください。

また、これらの属性を使用して、XML Web サービスによって生成されるリテラル スタイルの SOAP メッセージを制御することもできます。これらの属性を XML Web サービス メソッドに適用する方法の詳細については、「XML Web サービスを使用した XML シリアル化」を参照してください。

属性の詳細については、「Extending Metadata Using Attributes」を参照してください。

属性 対象 機能

XmlAnyAttributeAttribute

XmlAttribute オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメータ、または戻り値

逆シリアル化時に、スキーマで未定義のすべての XML 属性を表す XmlAttribute オブジェクトを配列に挿入します。

XmlAnyElementAttribute

XmlElement オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメータ、または戻り値

逆シリアル化時に、スキーマで未定義のすべての XML 要素を表す XmlElement オブジェクトを配列に挿入します。

XmlArrayAttribute

複合オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメータ、または戻り値

配列のメンバを XML 配列のメンバとして生成します。

XmlArrayItemAttribute

複合オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメータ、または戻り値

配列に挿入できる派生型を指定します。通常、XmlArrayAttribute と共に適用されます。

XmlAttributeAttribute

パブリック フィールド、パブリック プロパティ、パブリック パラメータ、または戻り値

メンバを XML 属性としてシリアル化します。

XmlChoiceIdentifierAttribute

パブリック フィールド、パブリック プロパティ、パブリック パラメータ、または戻り値

列挙体を使用して、メンバを明確に区別できるようにします。

XmlElementAttribute

パブリック フィールド、パブリック プロパティ、パブリック パラメータ、または戻り値

フィールドまたはプロパティを XML 要素としてシリアル化します。

XmlEnumAttribute

列挙体識別子であるパブリック フィールド

列挙体のメンバの要素名を指定します。

XmlIgnoreAttribute

パブリック プロパティとパブリック フィールド

クラスのシリアル化時に、そのクラスに含まれているプロパティまたはフィールドを無視します。

XmlIncludeAttribute

パブリック派生クラス宣言、およびパブリック メソッドの戻り値 (Web サービス記述言語 (WSDL: Web Service Description Language) ドキュメント用)

シリアル化されたときにクラスが認識されるように、スキーマの生成時にそのクラスを対象に含めます。

XmlRootAttribute

パブリック クラス宣言

属性ターゲットを XML ルート要素として XML シリアル化する方法を制御します。この属性を使用して、さらに名前空間と要素名を指定できます。

XmlTextAttribute

パブリック プロパティとパブリック フィールド

プロパティまたはフィールドを XML テキストとしてシリアル化します。

XmlTypeAttribute

パブリック クラス宣言

XML 型の名前および名前空間を指定します。

System.Xml.Serialization 名前空間にあるこれらの属性の他に、System.ComponentModel.DefaultValueAttribute 属性もフィールドに適用できます。DefaultValueAttribute は、メンバの値が指定されていない場合に、メンバに自動的に割り当てられる値を設定します。

エンコード済みの SOAP XML シリアル化を制御する方法については、「エンコード済み SOAP シリアル化を制御する属性」を参照してください。

関連項目

タスク

方法 : XML ストリームの代替要素名を指定する
方法 : オブジェクトをシリアル化する
方法 : オブジェクトを逆シリアル化する

参照

XmlSerializer

概念

属性を使用した XML シリアル化の制御

その他の技術情報

XML シリアル化および SOAP シリアル化

Footer image

Copyright © 2007 by Microsoft Corporation.All rights reserved.