SoapOption 列挙型

  • リファレンス

定義

名前空間:
System.Runtime.Remoting.Metadata
アセンブリ:
mscorlib.dll

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

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

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

public enum class SoapOption
[System.Flags]
[System.Serializable]
public enum SoapOption
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum SoapOption
[<System.Flags>]
[<System.Serializable>]
type 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」を参照してください。

適用対象