XmlTypeAttribute Classe

Référence

Définition

Espace de noms:: System.Xml.Serialization

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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.

Contrôle le schéma XML qui est généré lorsque la cible de l'attribut est sérialisée par XmlSerializer.

public ref class XmlTypeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)]
public class XmlTypeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)>]
type XmlTypeAttribute = class
    inherit Attribute

Public Class XmlTypeAttribute
Inherits Attribute

Héritage: Object

Attribute
XmlTypeAttribute

Attributs: AttributeUsageAttribute

Exemples

L’exemple suivant montre deux classes auxquelles l’application XmlTypeAttribute a été appliquée.


[XmlType(Namespace="http://www.cpandl.com",
TypeName="GroupMember")]
public ref class Person
{
public:
   String^ Name;
};


[XmlType(Namespace="http://www.cohowinery.com",
TypeName="GroupAddress")]
public ref class Address
{
public:
   String^ Line1;
   String^ Line2;
   String^ City;
   String^ State;
   String^ Zip;
};

public ref class Group
{
public:
   array<Person^>^Staff;
   Person^ Manager;
   Address^ Location;
};

[XmlType(Namespace = "http://www.cpandl.com",
TypeName = "GroupMember")]
public class Person
{
   public string Name;
}

[XmlType(Namespace = "http://www.cohowinery.com",
TypeName = "GroupAddress")]
public class Address
{
   public string Line1;
   public string Line2;
   public string City;
   public string State;
   public string Zip;
}

public class Group
{
   public Person[] Staff;
   public Person Manager;
   public Address Location;
}

<XmlType(Namespace := "http://www.cpandl.com", _
 TypeName := "GroupMember")> _
Public Class Person
    Public Name As String
End Class

<XmlType(Namespace := "http://www.cohowinery.com", _
 TypeName := "GroupAddress")> _ 
Public Class Address
    
    Public Line1 As String
    Public Line2 As String
    Public City As String
    Public State As String
    Public Zip As String
End Class

Public Class Group
    Public Staff() As Person
    Public Manager As Person
    Public Location As Address
End Class

Remarques

Appartient XmlTypeAttribute à une famille d’attributs qui contrôle la façon dont le XmlSerializer sérialise ou désérialise un objet. Pour obtenir la liste complète des attributs similaires, consultez Attributs qui contrôlent la sérialisation XML.

Vous pouvez appliquer la XmlTypeAttribute valeur à une déclaration de classe, de structure, d’énumération ou d’interface.

Appliquez la XmlTypeAttribute valeur à une classe pour spécifier l’espace de noms du type XML, le nom du type XML et s’il faut inclure le type dans le document de schéma XML. Pour afficher les résultats de la définition des propriétés de la XmlTypeAttribute classe, compilez votre application en tant qu’exécutable ou DLL et transmettez le fichier résultant à l’outil de définition de schéma XML (Xsd.exe). L’outil écrit le schéma, y compris la définition de type.

Notes

Si vous définissez la IncludeInSchema propriété falsesur , l’outil de définition de schéma XML (Xsd.exe) n’inclut pas le type dans le schéma. Par défaut, pour chaque classe publique, l’outil XSD génère un élément et un complexType élément de ce type.

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

Notes

Vous pouvez utiliser le mot XmlType dans votre code au lieu du plus long XmlTypeAttribute.

Constructeurs

XmlTypeAttribute()	Initialise une nouvelle instance de la classe XmlTypeAttribute.
XmlTypeAttribute(String)	Initialise une nouvelle instance de la classe XmlTypeAttribute et spécifie le nom du type XML.

Propriétés

AnonymousType	Obtient ou définit une valeur qui détermine si le type de schéma résultant est un type anonyme XSD.
IncludeInSchema	Obtient ou définit une valeur qui indique si le type doit être inclus dans les documents du schéma XML.
Namespace	Obtient ou définit l'espace de noms du type XML.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
TypeName	Obtient ou définit le nom du type XML.

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)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)

S’applique à