SoapOption Enumeración

Definición

Especifica las opciones de configuración de SOAP para su uso con la clase SoapTypeAttribute.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el 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
Herencia
SoapOption
Atributos

Campos

Nombre Valor Description
None 0

Opción predeterminada que indica que no se seleccionan opciones adicionales.

AlwaysIncludeTypes 1

Indica que el tipo siempre se incluirá en los elementos SOAP. Esta opción es útil al realizar la interoperabilidad soap con implementaciones SOAP que requieren tipos en todos los elementos.

XsdString 2

Indica que el tipo de cadena SOAP de salida en un sobre SOAP usa el XSD prefijo y que el XML resultante no tiene un atributo ID para la cadena.

EmbedAll 4

Indica que SOAP se generará sin referencias. Esta opción no está implementada actualmente.

Option1 8

Opción reservada pública para condiciones de interoperabilidad temporales; el uso cambiará.

Option2 16

Opción reservada pública para condiciones de interoperabilidad temporales; el uso cambiará.

Comentarios

La enumeración SoapOption se usa para especificar instrucciones para .NET Framework sobre cómo generará el SOAP.

Por ejemplo, mientras que una clase de forma predeterminada (con el SoapOptions.None valor de enumeración) podría estar remota en el 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"/>  

La serialización remota con la SoapOptions.XsdString opción genera el siguiente 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 obtener más información sobre los sobres SOAP, consulte www.w3.org/tr/soap/#_Toc478383494.

Se aplica a