SoapIncludeAttribute Classe

Définition

public ref class SoapIncludeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
    inherit Attribute

Public Class SoapIncludeAttribute
Inherits Attribute

Héritage

Object

Attribute

SoapIncludeAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant applique les SoapIncludeAttribute deux fois à une méthode de service Web XML. La méthode retourne un objet de type Vehicle (classe de base). Permet SoapIncludeAttribute à la méthode de retourner des instances de classes dérivées de la Vehicle classe.

Remarques

La SoapIncludeAttribute classe appartient à une famille d’attributs qui contrôle la façon dont les XmlSerializer sérialises, ou désérialise, un objet en tant que XML SOAP encodé. Le code XML résultant est conforme à la section 5 du document World Wide Web Consortium, SOAP (Simple Object Access Protocol) 1.1. Pour obtenir la liste complète des attributs similaires, consultez Attributs qui contrôlent la sérialisation SOAP encodée.

Pour sérialiser un objet en tant que message SOAP encodé, vous devez construire l’utilisation XmlSerializer d’un XmlTypeMapping objet créé avec la ImportTypeMapping méthode de la SoapReflectionImporter classe.

Lors de l’application SoapIncludeAttributedu , spécifiez la Type classe dérivée. Lorsque le XmlSerializer sérialise des objets qui incluent à la fois la base et les classes dérivées, il peut ensuite reconnaître les deux types d’objets.

Vous pouvez utiliser les SoapIncludeAttribute classes dérivées dans les documents de description de service écrits dans le langage WSDL (Web Services Description Language). Par exemple, si une méthode retourne un Object, appliquez la SoapIncludeAttribute méthode et spécifiez les types réels qui doivent être retournés.

Pour plus d’informations sur WSDL, consultez la spécification World Wide Web Consortium, Web Services Description Language (WSDL) 1.1.

Pour plus d’informations sur l’utilisation d’attributs, consultez Attributs.