SoapIncludeAttribute Classe

Définition

Espace de noms:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Source:

SoapIncludeAttribute.cs

Permet à XmlSerializer de reconnaître un type lorsqu'il sérialise ou désérialise un objet comme du XML SOAP encodé.

public ref 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.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 deux SoapIncludeAttribute 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 l’objet XmlSerializer sérialise ou désérialise un objet en tant que code XML SOAP encodé. Le code XML résultant est conforme à la section 5 du document du 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 le à l’aide XmlSerializer d’un XmlTypeMapping créé avec la ImportTypeMapping méthode de la SoapReflectionImporter classe .

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

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

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

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

Constructeurs

SoapIncludeAttribute(Type)

Initialise une nouvelle instance de la classe SoapIncludeAttribute à l'aide du type spécifié.

Propriétés

Type	Obtient ou définit le type de l'objet à utiliser lors de la sérialisation ou de la désérialisation d'un objet.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)