Partager via


Attributs qui contrôlent la sérialisation XML

Vous pouvez appliquer les attributs du tableau suivant à des classes et des membres de classe pour contrôler la manière dont XmlSerializer sérialise ou désérialise une instance de la classe. Pour comprendre comment ces attributs contrôlent la sérialisation XML, consultez Contrôle de la sérialisation XML à l'aide d'attributs.

Ces attributs peuvent également être utilisés pour contrôler les messages SOAP de style littéral générés par un service Web XML. Pour plus d'informations sur l'application de ces attributs à une méthode de services Web XML, consultez Sérialisation XML avec les services Web XML.

Pour plus d'informations sur les attributs, consultez Extending Metadata Using Attributes.

Attribut S'applique à Informations fournies

XmlAnyAttributeAttribute

Champ public, propriété, paramètre ou valeur de retour qui retourne un tableau d'objets XmlAttribute.

Lors de la désérialisation, le tableau est rempli avec les objets XmlAttribute qui représentent tous les attributs XML inconnus du schéma.

XmlAnyElementAttribute

Champ public, propriété, paramètre ou valeur de retour qui retourne un tableau d'objets XmlElement.

Lors de la désérialisation, le tableau est rempli avec les objets XmlElement qui représentent tous les éléments XML inconnus du schéma.

XmlArrayAttribute

Champ public, propriété, paramètre ou valeur de retour qui retourne un tableau d'objets complexes.

Les membres du tableau sont générés en tant que membres d'un tableau XML.

XmlArrayItemAttribute

Champ public, propriété, paramètre ou valeur de retour qui retourne un tableau d'objets complexes.

Types dérivés qui peuvent être insérés dans un tableau. S'applique habituellement avec XmlArrayAttribute.

XmlAttributeAttribute

Champ public, propriété, paramètre ou valeur de retour.

Le membre est sérialisé en tant qu'attribut XML.

XmlChoiceIdentifierAttribute

Champ public, propriété, paramètre ou valeur de retour.

L'ambiguïté du membre peut être levée à l'aide d'une énumération.

XmlElementAttribute

Champ public, propriété, paramètre ou valeur de retour.

Le champ ou la propriété est sérialisé en tant qu'élément XML.

XmlEnumAttribute

Champ public qui est un identificateur d'énumération.

Nom d'élément d'un membre d'énumération.

XmlIgnoreAttribute

Champs et propriétés publics.

La propriété ou le champ doit être ignoré lorsque la classe conteneur est sérialisée.

XmlIncludeAttribute

Déclarations de classe dérivée publiques et valeurs de retour de méthodes publiques pour les documents WSDL (Web Services Description Language).

La classe doit être incluse lors de la génération de schémas (afin d'être reconnue en cas de sérialisation).

XmlRootAttribute

Déclarations de classe publiques.

Contrôle la sérialisation XML de l'attribut cible en tant qu'élément racine XML. Utilisez l'attribut pour préciser l'espace de noms et le nom d'élément.

XmlTextAttribute

Champs et propriétés publics.

La propriété ou le champ doit être sérialisé en tant que texte XML.

XmlTypeAttribute

Déclarations de classe publiques.

Nom et espace de noms du type XML.

En plus de ces attributs, qui se trouvent tous dans l'espace de noms System.Xml.Serialization, vous pouvez également appliquer l'attribut System.ComponentModel.DefaultValueAttribute à un champ. DefaultValueAttribute définit la valeur qui sera assignée automatiquement au membre si aucune valeur n'est spécifiée.

Pour contrôler la sérialisation XML codée selon le protocole SOAP, consultez Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP.

Voir aussi

Tâches

Comment : spécifier un nom d'élément différent pour un flux XML
Comment : sérialiser un objet
Comment : désérialiser un objet

Référence

XmlSerializer

Concepts

Contrôle de la sérialisation XML à l'aide d'attributs

Autres ressources

Sérialisation XML et SOAP