SoapOption Enumeração

Definição

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

Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.

Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir 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
SoapOption
Atributos

Campos

Name Valor Description
None 0

A opção padrão indica que não há opções extra selecionadas.

AlwaysIncludeTypes 1

Indica que o tipo será sempre incluído nos elementos SOAP. Esta opção é útil ao realizar interoperabilidade SOAP com implementações SOAP que exigem tipos em todos os elementos.

XsdString 2

Indica que o tipo de string SOAP de saída num envelope SOAP usa o XSD prefixo, e que o XML resultante não tem um atributo ID para a string.

EmbedAll 4

Indica que o SOAP será gerado sem referências. Esta opção ainda não está implementada.

Option1 8

Opção reservada ao público para condições temporárias de interoperabilidade; O uso vai mudar.

Option2 16

Opção reservada ao público para condições temporárias de interoperabilidade; O uso vai mudar.

Observações

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

Por exemplo, enquanto uma classe por defeito (com o SoapOptions.None valor de enumeração) pode 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 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 mais informações sobre envelopes SOAP, consulte www.w3.org/tr/soap/#_Toc478383494.

Aplica-se a