Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

Introduction à la sérialisation XML

La sérialisation correspond au processus de conversion d'un objet en un formulaire facilement transportable. Par exemple, vous pouvez sérialiser un objet et le transporter par Internet via HTTP entre un client et un serveur. À l'autre extrémité, la désérialisation reconstruit l'objet du flux de données.

La sérialisation XML sérialise uniquement les champs publics et les valeurs de propriété d'un objet dans un flux de données XML. La sérialisation XML n'inclut pas d'informations de type. Par exemple, si vous disposez d'un objet Book qui existe dans l'espace de noms Library, il n'y a aucune garantie qu'il soit désérialisé dans un objet du même type.

Remarque Remarque

La sérialisation XML ne convertit pas les méthodes, les indexeurs, les champs privés ni les propriétés en lecture seule (à l'exception des collections en lecture seule). Pour sérialiser la totalité des champs et des propriétés d'un objet, publics et privés, utilisez DataContractSerializer au lieu de la sérialisation XML.

La classe centrale de la sérialisation XML est la classe XmlSerializer et les méthodes les plus importantes de cette classe sont les méthodes Serialize et Deserialize. XmlSerializer crée des fichiers C# et les compile dans des fichiers .dll pour exécuter cette sérialisation. Dans .NET Framework 2.0, l'Outil XML Serializer Generator (Sgen.exe) est conçu pour générer ces assemblys de sérialisation en avance de sorte qu'ils soient déployés avec votre application et pour améliorer les performances de démarrage. Le flux de données XML généré par XmlSerializer est conforme aux recommandations 1.0 du World Wide Web Consortium (www.w3.org) en matière de langage XSD (XML Schema Definition). En outre, les types de données générés sont conformes au document intitulé « XML Schema Part 2: Datatypes ».

Les données de vos objets sont décrites à l'aide des constructions d'un langage de programmation, telles que les classes, les champs, les propriétés, les types primitifs, les tableaux voire du code XML incorporé sous forme d'objets XmlElement ou XmlAttribute. Vous pouvez créer vos propres classes, annotées avec des attributs ou utiliser l'outil XML Schema Definition pour générer des classes à partir d'un schéma XML existant.

Si vous disposez d'un schéma XML, vous pouvez exécuter l'outil XML Schema Definition pour générer un ensemble de classes fortement typées sur le schéma et annotées avec des attributs. Lorsqu'une instance d'une telle classe est sérialisée, le code XML généré respecte le schéma XML. Lorsque vous disposez d'une telle classe, vous pouvez programmer à l'aide d'un modèle d'objet manipulé facilement tout en garantissant que le code XML généré se conforme au schéma XML. Vous pouvez également utiliser d'autres classes dans le .NET Framework, telles que les classes XmlReader et XmlWriter, pour analyser et écrire un flux de données XML. Pour plus d'informations, consultez Documents et données XML. Ces classes vous permettent d'analyser tout flux de données XML. À l'inverse, utilisez XmlSerializer lorsque le flux de données XML est supposé se conformer à un schéma XML connu.

Les attributs contrôlent le flux de données XML généré par la classe XmlSerializer, en vous permettant de définir l'espace de noms XML, le nom d'élément, le nom de l'attribut, etc. du flux de données XML. Pour plus d'informations sur ces attributs et sur la manière dont ils contrôlent la sérialisation XML, consultez Contrôle de la sérialisation XML à l'aide d'attributs. Pour consulter une table des attributs utilisés pour contrôler le code XML généré, reportez-vous à Attributs qui contrôlent la sérialisation XML.

En outre, la classe XmlSerializer peut sérialiser un objet et générer un flux de données XML encodé selon le protocole SOAP. Le XML généré est conforme à la section 5 du document World Wide Web Consortium intitulé « Protocole SOAP (Simple Object Access Protocol) 1.1 ». Pour plus d'informations sur ce processus, consultez Comment : sérialiser un objet en tant que flux XML encodé selon le protocole SOAP. Pour consulter une table des attributs qui contrôlent le code XML généré, reportez-vous à Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP.

La classe XmlSerializer génère les messages SOAP créés par les services Web XML et passés à ces derniers. Pour contrôler les messages SOAP, vous pouvez appliquer des attributs aux classes, valeurs de retour, paramètres et champs trouvés dans un fichier de services Web XML (.asmx). Vous pouvez utiliser les attributs répertoriés dans « Attributs qui contrôlent la sérialisation XML » et « Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP » car un service Web XML peut utiliser le style SOAP littéral ou encodé. Pour plus d'informations sur l'utilisation d'attributs pour contrôler le code XML généré par un service Web XML, consultez Sérialisation XML avec les services Web XML. Pour plus d'informations sur les services Web SOAP et XML, consultez Customizing SOAP Messages.

Lorsque vous créez une application qui utilise XmlSerializer, vous devez prendre en compte les éléments suivants et leurs conséquences :

  • XmlSerializer crée des fichiers C# (.cs) et les compile sous forme de fichiers .dll dans le répertoire nommé par la variable d'environnement TEMP. La sérialisation se produit avec ces dll.

    Remarque Remarque

    Ces assemblys de sérialisation peuvent être générés en avance et signés à l'aide de l'outil SGen.exe. Cela ne fonctionne pas avec un serveur de services Web. En d'autres termes, ces assemblys sont réservés à une utilisation par le client et à une sérialisation manuelle.

    Le code et les dll sont vulnérables face à un processus malveillant lors de leur création et de leur compilation. Lors de l'utilisation d'un ordinateur qui exécute Microsoft Windows NT 4.0 ou version ultérieure, deux utilisateurs ou plus peuvent partager le répertoire TEMP. Le partage d'un répertoire TEMP est dangereux si les deux comptes disposent de privilèges de sécurité différents et que le compte présentant le privilège le plus élevé exécute une application à l'aide de XmlSerializer. Dans ce cas, un utilisateur peut percer la sécurité de l'ordinateur en remplaçant le fichier .cs ou .dll compilé. Pour éliminer ce problème, vérifiez toujours que chaque compte de l'ordinateur dispose de son propre profil. Par défaut, la variable d'environnement TEMP pointe vers un répertoire différent pour chaque compte.

  • Si un utilisateur malveillant envoie un flux de données XML continu à un serveur Web (une attaque par déni de service), XmlSerializer continue de traiter les données jusqu'à ce que l'ordinateur manque de ressources.

    Ce type d'attaque est éliminé si vous utilisez un ordinateur qui exécute des Services Internet (IIS) et que votre application s'exécute dans IIS. IIS comprend une porte qui ne traite pas les flux de données supérieurs à une quantité définie (la valeur par défaut correspond à 4 Ko). Si vous créez une application qui n'utilise pas IIS et qui désérialise à l'aide de XmlSerializer, vous devez implémenter une porte semblable pour empêcher une attaque par déni de service.

  • XmlSerializer sérialise des données et exécute tout code à l'aide de n'importe quel type donné.

    Un objet malveillant présente une menace dans deux situations. Il peut exécuter un code malveillant ou injecter un tel code dans le fichier C# créé par XmlSerializer. Dans le premier cas, si un objet malveillant essaie d'exécuter une procédure destructrice, la sécurité d'accès du code empêche tout préjudice éventuel. Dans le deuxième cas, il est possible, en théorie, qu'un objet malveillant puisse injecter d'une façon ou d'une autre du code dans le fichier C# créé par XmlSerializer. Bien que ce problème ait été étudié de manière approfondie et qu'une telle attaque soit considérée comme improbable, veillez à ne jamais sérialiser de données de type inconnu et non fiable.

  • Les données sensibles sérialisées peuvent être vulnérables.

    Une fois que XmlSerializer a sérialisé des données, il peut être stocké comme un fichier XML ou tout autre magasin de données. Si d'autres processus peuvent accéder à votre magasin de données, ou que celui-ci est visible sur un intranet ou sur Internet, les données peuvent être volées et utilisées de manière malveillante. Par exemple, si vous créez une application qui sérialise des commandes qui incluent des numéros de carte de crédit, les données sont très sensibles. Pour empêcher cela, protégez toujours votre magasin de données et prenez les mesures nécessaires pour assurer sa confidentialité.

L'exemple de code suivant affiche une classe de base avec un champ public.

public class OrderForm
{
    public DateTime OrderDate;
}

Lorsqu'une instance de cette classe est sérialisée, elle peut se présenter comme suit.

<OrderForm>
    <OrderDate>12/12/01</OrderDate>
</OrderForm>

Pour obtenir plus d'exemples de sérialisation, consultez Exemples de sérialisation XML.

Les éléments suivants peuvent être sérialisés à l'aide de la classe XmLSerializer :

  • Propriétés publiques de lecture/écriture et champs de classes publiques.

  • Classes qui implémentent ICollection ou IEnumerable.

    Remarque Remarque

    Seules les collections sont sérialisées, pas les propriétés publiques.

  • Objets XmlElement.

  • Objets XmlNode.

  • Objets DataSet.

Pour plus d'informations sur la sérialisation ou la désérialisation d'objets, consultez Comment : sérialiser un objet et Comment : désérialiser un objet.

La classe XmlSerializer vous offre un contrôle complet et flexible lorsque vous sérialisez un objet en tant que code XML. Si vous créez un service Web XML, vous pouvez appliquer des attributs qui contrôlent la sérialisation des classes et des membres pour garantir que le résultat XML se conforme à un schéma spécifique.

Par exemple, XmlSerializer vous permet de :

  • Spécifier si un champ ou une propriété doit être encodé comme un attribut ou un élément.

  • Spécifier un espace de noms XML à utiliser.

  • Spécifier le nom d'un élément ou d'un attribut si le nom d'un champ ou d'une propriété n'est pas approprié.

Un autre avantage de la sérialisation XML est qu'aucune contrainte n'est définie sur les applications que vous développez, tant que le flux de données XML généré se conforme à un schéma donné. Imaginez un schéma utilisé pour décrire des livres. Il comprend un titre, un auteur, un éditeur et un élément de numéro ISBN. Vous pouvez développer une application qui traite les données XML de la manière dont vous le souhaitez, par exemple, comme une commande ou un inventaire de livres. Dans les deux cas, la seule spécification consiste en ce que le flux de données XML se conforme au schéma XSD spécifié.

Les éléments suivants doivent être pris en compte lors de l'utilisation de la classe XmlSerializer :

  • L'outil Sgen.exe est conçu expressément pour générer des assemblys de sérialisation en vue d'obtenir des performances optimales.

  • Les données sérialisées ne contiennent que les données elles-mêmes et la structure de vos classes. Les informations relatives à l'identité et aux assemblys ne sont pas incluses.

  • Seuls les champs et les propriétés publics peuvent être sérialisés. Les propriétés doivent disposer d'accesseurs publics (méthodes get et set). Si vous devez sérialiser des données non publiques, utilisez la classe DataContractSerializer plutôt que la sérialisation XML.

  • Une classe doit disposer d'un constructeur par défaut pour être sérialisée par XmlSerializer.

  • Les méthodes ne peuvent pas être sérialisées.

  • XmlSerializer peut traiter des classes qui implémentent différemment IEnumerable ou ICollection si elles répondent à certaines spécifications, comme suit.

    Une classe qui implémente IEnumerable doit implémenter une méthode Add publique n'acceptant qu'un paramètre. Le paramètre de la méthode Add doit être cohérent (polymorphe) avec le type retourné par la propriété IEnumerator.Current retournée par la méthode GetEnumerator.

    Une classe qui implémente ICollection en plus de IEnumerable (comme CollectionBase) doit disposer d'une propriété Item publique indexée (un indexeur dans C#) qui accepte un entier et d'une propriété Count publique de type integer. Le paramètre passé à la méthode Add doit être du même type que celui retourné par la propriété Item ou correspondre à l'une des bases de ce type.

    Dans le cas de classes qui implémentent ICollection, les valeurs à sérialiser sont récupérées à partir de la propriété Item indexée et non en appelant GetEnumerator. De même, les champs et les propriétés publics ne sont pas sérialisés, à l'exception des champs publics qui retournent une autre classe de collection (une classe qui implémente ICollection). Pour obtenir un exemple, consultez Exemples de sérialisation XML.

Le document du World Wide Web Consortium (www.w3.org) intitulé « XML Schema Part 2: Datatypes » spécifie les types de données simples autorisés dans un schéma de langage XSD. Pour la plupart d'entre eux (par exemple, int et decimal), il existe un type de données correspondant dans le .NET Framework. Toutefois, ce n'est pas le cas pour certains types de données XML (par exemple, le type de données NMTOKEN). Dans de tels cas, si vous utilisez l'outil XML Schema Definition (Outil XML Schema Definition (Xsd.exe)) pour générer des classes à partir d'un schéma, un attribut approprié est appliqué à un membre de type String et sa propriété DataType a pour valeur le nom de type de données XML. Par exemple, si un schéma contient un élément nommé "MyToken" avec le type de données XML NMTOKEN, la classe générée peut contenir un membre tel qu'illustré dans l'exemple suivant.

[XmlElement(DataType = "NMTOKEN")]
public string MyToken;

De la même façon, si vous créez une classe qui doit se conformer à un schéma XML spécifique (XSD), vous devez appliquer l'attribut approprié et affecter à sa propriété DataType le nom de type de données XML souhaité.

Pour une liste complète des mappages de type, consultez la propriété DataType pour chacune des classes d'attributs suivantes :

  • SoapAttributeAttribute

  • SoapElementAttribute

  • XmlArrayItemAttribute

  • XmlAttributeAttribute

  • XmlElementAttribute

  • XmlRootAttribute

Ajouts de la communauté

Afficher: