次の方法で共有


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

次の表の属性をクラスとクラス メンバーに適用して、 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 シリアル化を制御する属性」を参照してください。

こちらも参照ください