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	临时互操作条件的公共保留选项；其用途将会改变。
Option2	16	临时互操作条件的公共保留选项；其用途将会改变。
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。