Attributs qui contrôlent la sérialisation XML

  • Article

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

Attribut S’applique à Spécifie
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.
ObsoleteAttribute Champs et propriétés publics. La propriété ou le champ va être ignoré lorsque la classe conteneur est sérialisée.

En plus de ces attributs, qui se trouvent tous dans l'espace de noms System.Xml.Serialization, vous pouvez également appliquer l'attribut 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 encodée selon le protocole SOAP, consultez Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP.

Voir aussi