Condividi tramite


SoapOption Enumerazione

Definizione

Specifica le opzioni di configurazione SOAP da utilizzare con la classe SoapTypeAttribute.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

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
Ereditarietà
SoapOption
Attributi

Campi

AlwaysIncludeTypes 1

Indica che il tipo verrà sempre incluso negli elementi SOAP. Questa opzione risulta particolarmente utile per l'interoperabilità SOAP con implementazioni SOAP che richiedono i tipi di tutti gli elementi.

EmbedAll 4

Indica che SOAP verrà generato senza riferimenti. L'opzione non è attualmente implementata.

None 0

Opzione predefinita che indica che non sono selezionate ulteriori opzioni.

Option1 8

Opzione riservata pubblica per condizioni di interoperabilità temporanee. L'utilizzo verrà modificato.

Option2 16

Opzione riservata pubblica per condizioni di interoperabilità temporanee. L'utilizzo verrà modificato.

XsdString 2

Indica che il tipo della stringa SOAP di output in SOAP Envelope usa il prefisso XSD e che il codice XML risultante non ha un attributo ID per la stringa.

Commenti

L'enumerazione SoapOption viene usata per specificare le istruzioni per .NET Framework su come genererà SOAP.

Ad esempio, mentre una classe per impostazione predefinita (con il SoapOptions.None valore di enumerazione) potrebbe essere remota nel formato SOAP come:

<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 serializzazione remota con l'opzione SoapOptions.XsdString produce il codice XML seguente:

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

Per altre informazioni sulle buste SOAP, vedere www.w3.org/tr/soap/#_Toc478383494.

Si applica a