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 Interop 時很有用處。
EmbedAll	4	指示 SOAP 將以沒有參考的方式來產生。 這個選項目前尚未實作。
None	0	預設選項，指出沒有額外的選項被選取。
Option1	8	暫存 Interop 條件的公用 (Public) 保留選項，其用法將會變更。
Option2	16	暫存 Interop 條件的公用 (Public) 保留選項，其用法將會變更。
XsdString	2	指出 SOAP 封套中的輸出 SOAP 字串類型使用 XSD 前置詞，且產生的結果 XML 沒有該字串的 ID 屬性。

備註

SoapOption列舉會用來指定 .NET Framework 的指示，以瞭解其如何產生 SOAP。

例如，雖然類別預設 (與 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。