エンコード済み SOAP シリアル化を制御する属性
W3C (World Wide Web Consortium) (www.w3.org) のドキュメント『Simple Object Access Protocol (SOAP) 1.1』には、SOAP パラメータをエンコードする方法について説明するオプションのセクション (セクション 5) が含まれています。この仕様のセクション 5 に準拠するには、System.Xml.Serialization 名前空間に含まれている一連の専用属性を使用する必要があります。これらの属性をクラスやクラス メンバに適宜適用し、XmlSerializer を使用してその (1 つまたは複数の) クラスのインスタンスをシリアル化します。
これらの属性、およびその適用対象と機能を次の表に示します。これらの属性を使用して XML シリアル化を制御する方法については、「方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する」および「方法 : エンコード済みの SOAP XML シリアル化をオーバーライドする」を参照してください。
属性の詳細については、「属性を使用したメタデータの拡張」を参照してください。
| 属性 | 適用対象 | 機能 |
|---|---|---|
パブリックなフィールド、プロパティ、パラメータ、または戻り値 |
クラス メンバを XML 属性としてシリアル化します。 |
|
パブリックなフィールド、プロパティ、パラメータ、または戻り値 |
クラスを XML 要素としてシリアル化します。 |
|
列挙体識別子であるパブリック フィールド |
列挙体メンバの要素名を指定します。 |
|
パブリック プロパティおよびパブリック フィールド |
クラスのシリアル化時に、そのクラスに含まれているプロパティまたはフィールドを無視します。 |
|
パブリック派生クラス宣言、およびパブリック メソッド (Web サービス記述言語 (WSDL : Web Service Description Language) ドキュメント用) |
シリアル化されたときにクラスが認識されるように、スキーマの生成時にそのクラスを対象に含めます。 |
|
パブリック クラス宣言 |
クラスを XML 型としてシリアル化します。 |
参照
処理手順
方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する
方法 : エンコード済みの SOAP XML シリアル化をオーバーライドする
方法 : オブジェクトをシリアル化する
方法 : オブジェクトを逆シリアル化する