Compartir a través de


SoapOption Enumeración

Definición

Especifica las opciones de configuración SOAP que se utilizan 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

AlwaysIncludeTypes 1

Indica que siempre se incluirán tipos en los elementos SOAP. Esta opción resulta muy útil en la interoperabilidad SOAP con implementaciones SOAP que requieren tipos en todos los elementos.

EmbedAll 4

Indica que SOAP se generará sin referencias. Esta propiedad no está implementada actualmente.

None 0

Opción predeterminada que indica que no se han seleccionado opciones adicionales.

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á.

XsdString 2

Indica que el tipo de cadena SOAP de salida de un sobre SOAP utiliza el prefijo XSD, y que el elemento XML resultante no tiene un atributo de identificación de la cadena.

Comentarios

La SoapOption enumeración 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