SoapOption Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Attributs
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 |
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 < world</str1>
<str2 id="ref-8"><</str2>
<str3 id="ref-9">< 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 < world</str1>
<str2 xsi:type="xsd:string"><</str2>
<str3 xsi:type="xsd:string">< world</str3>
<str4 xsi:type="xsd:string">hello < world</str4>
Pour plus d’informations sur les enveloppes SOAP, consultez www.w3.org/tr/soap/#_Toc478383494.