Partager via

Attributs qui contrôlent la sérialisation XML

Vous pouvez appliquer les attributs du tableau suivant aux classes et aux membres de classe pour contrôler la façon dont le 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 des services web XML.

Pour plus d’informations sur les attributs, consultez Attributs.

Caractéristique 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 d’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 d’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 seront 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. Généralement appliqué conjointement avec un 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. Le membre peut être plus ambiguïté à l’aide d’une énumération.
XmlElementAttribute 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.
XmlEnumAttribute Champ public qui est un identificateur d’énumération. Nom d’élément d’un membre d’énumération.
XmlIgnoreAttribute Propriétés publiques et champs. La propriété ou le champ doit être omise lorsque la classe conteneur est sérialisée.
XmlIncludeAttribute Déclarations de classe dérivées 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 (à reconnaître lors de la sérialisation).
XmlRootAttribute Déclarations de classe publiques. Contrôle la sérialisation XML de la cible d’attribut en tant qu’élément racine XML. Utilisez l’attribut pour spécifier davantage l’espace de noms et le nom de l’élément.
XmlTextAttribute Propriétés publiques et champs. 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 Propriétés publiques et champs. La propriété ou le champ est ignoré lorsque la classe conteneur est sérialisée.

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

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

Voir aussi