SoapOption 列挙型

定義

名前空間:

System.Runtime.Remoting.Metadata

アセンブリ:

mscorlib.dll

SoapTypeAttribute クラスで使用する SOAP 構成オプションを指定します。

この列挙体は、メンバー値のビットごとの組み合わせをサポートしています。

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

public enum class SoapOption

[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum SoapOption

[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapOption = 

Public Enum SoapOption

継承

Object

ValueType

Enum

SoapOption

属性

FlagsAttribute SerializableAttribute ComVisibleAttribute

フィールド

AlwaysIncludeTypes	1	型が常に SOAP 要素に含まれることを示します。 このオプションは、すべての要素で型を必要とする SOAP 実装で SOAP 相互運用を実行する場合に役立ちます。
EmbedAll	4	参照なしで SOAP が生成されることを示します。 このオプションは現在実装されていません。
None	0	追加のオプションが何も選択されていないことを示す既定のオプション。
Option1	8	一時的な相互運用状態に対して予約されているパブリック オプション。使用方法は変更されます。
Option2	16	一時的な相互運用状態に対して予約されているパブリック オプション。使用方法は変更されます。
XsdString	2	SOAP エンベロープ内の出力 SOAP 文字列型で XSD プレフィックスが使われることと、結果として得られる XML に文字列の ID 属性が含まれないことを示します。

注釈

列挙体は SoapOption 、SOAP の生成方法に関する .NET Framework への命令を指定するために使用されます。

たとえば、既定では (列挙値を SoapOptions.None 持つ) クラスは、次のように SOAP 形式でリモート化される場合があります。

<member1>10</member1>  
<member2 id="ref-3">hello</member2>  
<member3 href="#ref-3"/>  
<member4 href="#ref-4"/>  
<member4shared href="#ref-4"/>  
<member5 href="#ref-5"/>  
<member6 id="ref-6" xsi:type="SOAP-ENC:string">Hello World</member6>  
<str1 id="ref-7">hello &#60; world</str1>  
<str2 id="ref-8">&#60;</str2>  
<str3 id="ref-9">&#60; world</str3>  
<str4 href="#ref-7"/>  

オプションを使用した SoapOptions.XsdString リモート処理のシリアル化では、次の XML が生成されます。

<member1 xsi:type="xsd:int">10</member1>  
<member2 xsi:type="xsd:string">hello</member2>  
<member3 xsi:type="xsd:string">hello</member3>  
<member4 href="#ref-3"/>  
<member4shared href="#ref-3"/>  
<member5 href="#ref-4"/>  
<member6 xsi:type="xsd:string">Hello World</member6>  
<str1 xsi:type="xsd:string">hello &#60; world</str1>  
<str2 xsi:type="xsd:string">&#60;</str2>  
<str3 xsi:type="xsd:string">&#60; world</str3>  
<str4 xsi:type="xsd:string">hello &#60; world</str4>  

SOAP エンベロープの詳細については、「 www.w3.org/tr/soap/#_Toc478383494」を参照してください。