エンコード済み SOAP シリアル化を制御する属性

World Wide Web コンソーシアム (W3C) のドキュメント『Simple Object Access Protocol (SOAP) 1.1』には、SOAP パラメーターのエンコード方法について説明したオプションのセクション (セクション 5) が含まれています。 このセクション 5 の仕様に準拠するには、System.Xml.Serialization 名前空間で指定されている特殊な属性セットを使用する必要があります。 これらの属性をクラスやクラスのメンバーに適宜適用し、XmlSerializer を使用して、クラスのインスタンスをシリアル化します。

これらの属性、およびその適用対象と機能を次の表に示します。 これらの属性を使用して XML シリアル化を制御する方法の詳細については、「方法: オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する」と「方法: SOAP エンコード済み XML シリアル化をオーバーライドする」を参照してください。

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

属性 対象 指定内容
SoapAttributeAttribute パブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値 クラス メンバーを XML 属性としてシリアル化します。
SoapElementAttribute パブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値 クラスを XML 要素としてシリアル化します。
SoapEnumAttribute 列挙体識別子であるパブリック フィールド 列挙体のメンバーの要素名を指定します。
SoapIgnoreAttribute パブリック プロパティとパブリック フィールド クラスのシリアル化時に、そのクラスに含まれているプロパティまたはフィールドを無視します。
SoapIncludeAttribute パブリック派生クラス宣言、およびパブリック メソッド (Web サービス記述言語 (WSDL: Web Service Description Language) ドキュメント用) シリアル化時に認識されるように、スキーマの生成時にその型を対象に含めます。
SoapTypeAttribute パブリック クラス宣言 クラスを XML 型としてシリアル化します。

関連項目