XmlTypeAttribute Classe

Définition

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

Exemples

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


[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

XmlTypeAttributeAppartient à une famille d’attributs qui contrôle la manière dont 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 XmlTypeAttribute à une classe, une structure, une énumération ou une déclaration d’interface.

Appliquez XmlTypeAttribute à une classe pour spécifier l’espace de noms du type XML, le nom de 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 sous la forme d’un fichier exécutable ou d’une dll et transmettez le fichier résultant à l' outil XML Schema Definition (Xsd.exe). L’outil écrit le schéma, y compris la définition du type.

Notes

Si vous affectez IncludeInSchema à la propriété la valeur false , l' outil XML Schema Definition (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 complexType et un é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 à

Voir aussi