SoapOption Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Atributos
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 |
Comentários
A SoapOption
enumeração é usada para especificar instruções para o .NET Framework sobre como ela gerará o SOAP.
Por exemplo, enquanto uma classe por padrão (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 < world</str1>
<str2 id="ref-8"><</str2>
<str3 id="ref-9">< world</str3>
<str4 href="#ref-7"/>
A serialização remota com a opção SoapOptions.XsdString
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 < world</str1>
<str2 xsi:type="xsd:string"><</str2>
<str3 xsi:type="xsd:string">< world</str3>
<str4 xsi:type="xsd:string">hello < world</str4>
Para obter mais informações sobre envelopes SOAP, consulte www.w3.org/tr/soap/#_Toc478383494.