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, voir 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 relatives à l'application de ces attributs à une méthode de services Web XML, voir Sérialisation XML à l'aide des services Web XML.
Pour plus d'informations sur les attributs, voir Extending Metadata Using Attributes.
| Attribut | Application à | Informations fournies |
|---|---|---|
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 sera rempli d'objets XmlAttribute qui représentent tous les attributs XML inconnus du schéma. |
|
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 d'objets XmlElement qui représentent tous les éléments XML inconnus du schéma. |
|
Champ public, propriété, paramètre, ou valeur de retour qui retourne un tableau d'objets complexes. |
Les membres du tableau seront générés en tant que membres d'un tableau XML. |
|
Champ public, propriété, paramètre, ou valeur de retour qui retourne un tableau d'objets complexes. |
Les types dérivés qui peuvent être insérés dans un tableau. S'appliquent habituellement en association avec XmlArrayAttribute. |
|
Champ public, propriété, paramètre ou valeur de retour. |
Le membre sera sérialisé en tant qu'attribut XML. |
|
Champ public, propriété, paramètre ou valeur de retour. |
Le membre peut être davantage désambiguïsé à l'aide d'une énumération. |
|
Champ public, propriété, paramètre ou valeur de retour. |
Le champ ou la propriété sera sérialisé en tant qu'élément XML. |
|
Champ public qui est un identificateur d'énumération. |
Nom d'élément d'un membre de l'énumération. |
|
Champs et propriétés publics |
La propriété ou le champ doit être ignoré lorsque la classe conteneur est sérialisée. |
|
Déclarations de classe dérivée publique et valeurs de retour des méthodes publiques pour des documents WSDL (Web Service Description Language). |
La classe doit être incluse lors de la génération de schémas (à reconnaître lors de leur sérialisation). |
|
Déclarations de classe publique. |
Contrôle la sérialisation XML de la cible de l'attribut comme un élément racine XML. Utilisez l'attribut pour spécifier plus avant l'espace de noms et le nom d'élément. |
|
Champs et propriétés publics |
Le champ ou la propriété doit être sérialisé en tant que texte XML. |
|
Déclarations de classe publique. |
Le nom et l'espace de noms du type XML. |
En plus de ces attributs qui figurent 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 automatiquement assignée au membre si aucune valeur n'est spécifiée.
Pour contrôler la sérialisation XML codée en SOAP, voir Attributs qui contrôlent la sérialisation codée en SOAP.
Voir aussi
Tâches
Comment : Spécifier un autre nom d'élément pour un flux XML
Comment : Sérialiser un objet
Comment : Désérialiser un objet
Référence
Concepts
Contrôle de la sérialisation XML à l'aide d'attributs