XmlTypeAttribute Classe
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.
Contrôle le schéma XML généré lorsque la cible d’attribut est sérialisée par le 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 AttributePublic Class XmlTypeAttribute
Inherits Attribute- Héritage
- Attributs
Exemples
L’exemple suivant montre deux classes auxquelles l’application XmlTypeAttribute a été appliquée.
[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 classe, la structure, l’énumération ou la déclaration d’interface.
Appliquez la XmlTypeAttribute valeur à une classe pour spécifier l’espace de noms du type XML, le nom du type XML et indiquez 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 XML Schema Definition Tool (Xsd.exe). L’outil écrit le schéma, y compris la définition de type.
Note
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.
Note
Vous pouvez utiliser le mot XmlType dans votre code au lieu du plus long XmlTypeAttribute.
Constructeurs
| Nom | Description |
|---|---|
| XmlTypeAttribute() |
Initialise une nouvelle instance de la classe XmlTypeAttribute. |
| XmlTypeAttribute(String) |
Initialise une nouvelle instance de la XmlTypeAttribute classe et spécifie le nom du type XML. |
Propriétés
| Nom | Description |
|---|---|
| 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 s’il faut inclure le type dans les documents de schéma XML. |
| Namespace |
Obtient ou définit l’espace de noms du type XML. |
| TypeId |
En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute) |
| TypeName |
Obtient ou définit le nom du type XML. |
Méthodes
| Nom | Description |
|---|---|
| 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 pour cette instance. (Hérité de Attribute) |
| GetType() |
Obtient la 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 de la classe dérivée. (Hérité de Attribute) |
| Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| _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 d’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 méthodes exposées par un objet. (Hérité de Attribute) |
