SoapOption Enumeração

Definição

Namespace:

System.Runtime.Remoting.Metadata

Assembly:

mscorlib.dll

Especifica as opções de configuração de SOAP para serem usadas com a classe SoapTypeAttribute.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

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

Herança

Object

ValueType

Enum

SoapOption

Atributos

FlagsAttribute SerializableAttribute ComVisibleAttribute

Campos

AlwaysIncludeTypes	1	Indica que esse tipo sempre será incluído nos elementos SOAP. Essa opção é útil ao executar a interoperabilidade de SOAP com implementações de SOAP que exigem tipos em todos os elementos.
EmbedAll	4	Indica que o SOAP será gerado sem referências. Essa opção não está implementada no momento.
None	0	A opção padrão que indica que não há opções adicionais selecionadas.
Option1	8	Opção pública reservada para condições temporárias de interoperabilidade; o uso será alterado.
Option2	16	Opção pública reservada para condições temporárias de interoperabilidade; o uso será alterado.
XsdString	2	Indica que o tipo de cadeia de caracteres SOAP de saída em um Envelope SOAP usa o prefixo XSD e que o XML resultante não tem um atributo de ID para a cadeia de caracteres.

Comentários

A SoapOption enumeração é usada para especificar instruções para o .NET Framework sobre como ele irá gerar o SOAP.

Por exemplo, embora uma classe por padrão (com o SoapOptions.None valor de enumeração) possa ser remota no formato SOAP como:

<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"/>  

A serialização de comunicação remota com a SoapOptions.XsdString opção produz o seguinte 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>  

Para obter mais informações sobre envelopes SOAP, consulte www.w3.org/tr/soap/#_Toc478383494.