SoapOption Énumération

Définition

Espace de noms:

System.Runtime.Remoting.Metadata

Assembly:

mscorlib.dll

Spécifie les options de configuration SOAP à utiliser avec la classe SoapTypeAttribute.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code.

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

Héritage

Object

ValueType

Enum

SoapOption

Attributs

FlagsAttribute SerializableAttribute ComVisibleAttribute

Champs

AlwaysIncludeTypes	1	Indique que le type est toujours inclus sur les éléments SOAP. Cette option est utile lors de l'utilisation de l'interopérabilité SOAP avec des implémentations SOAP qui requièrent des types sur tous les éléments.
EmbedAll	4	Indique que le format SOAP est généré sans références. Cette option n'est pas implémentée à l'heure actuelle.
None	0	Option par défaut indiquant qu'aucune option supplémentaire n'est sélectionnée.
Option1	8	Option publique réservée à des conditions d'interopérabilité temporaires ; son utilisation sera modifiée.
Option2	16	Option publique réservée à des conditions d'interopérabilité temporaires ; son utilisation sera modifiée.
XsdString	2	Indique que le type de chaîne SOAP de sortie dans une enveloppe SOAP utilise le préfixe XSD et que le XML résultant n’a pas d’attribut d’ID pour la chaîne.

Remarques

L’énumération SoapOption est utilisée pour spécifier des instructions au .NET Framework sur la façon dont il générera le SOAP.

Par exemple, alors qu’une classe par défaut (avec la SoapOptions.None valeur d’énumération) peut être distante au format SOAP comme suit :

<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 communication à distance de la sérialisation avec l’option SoapOptions.XsdString génère le code XML suivant :

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

Pour plus d’informations sur les enveloppes SOAP, consultez www.w3.org/tr/soap/#_Toc478383494.