Partager via

L'outil XML Schema Definition Tool et la sérialisation XML

  • Article

L'outil XML Schema Definition Tool (Xsd.exe) est installé en même temps que les outils .NET Framework qui font partie intégrante du Kit de développement .NET Framework SDK. L'outil est conçu essentiellement pour remplir deux objectifs :

  • Pour générer soit des fichiers de classe C#, soit de classe Visual Basic qui se conforment à un schéma XSD spécifique. L'outil prend un schéma XML comme argument et génère un fichier qui contient un nombre de classes qui, lorsqu'elles sont sérialisées à l'aide de XmlSerializer, se conforment au schéma.
  • Pour générer un document de schéma XML à partir d'un fichier .dll ou .exe. Si vous avez besoin de voir le schéma d'un jeu de fichiers que vous avez soit créé, soit qui a été modifié avec des attributs, passez la DLL ou l'EXE sous la forme d'un argument à l'outil pour générer le schéma XML.

Pour obtenir des informations sur cet outil (entre autres), consultez Outils .NET Framework. Pour des informations relatives aux options de l'outil, consultez Outil XML Schema Definition Tool (Xsd.exe).

Pour générer des classes qui se conforment à un schéma spécifique

  1. Ouvrez une fenêtre d'invite de commandes.

  2. Passez le schéma XML sous la forme d'un argument à l'outil Schema Definition qui crée un ensemble de classes correspondant exactement au schéma XML. Par exemple :

    xsd mySchema.xsd

    L'outil ne peut traiter que des schémas qui référencent la spécification XML du World Wide Web Consortium du 16 mars 2001. Ce qui signifie que l'espace de noms du schéma XML doit être " http://www.w3.org/2001/XMLSchema " comme le montre l'exemple suivant.

    <?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  3. Modifiez les classes à l'aide de méthodes, de propriétés ou de champs, selon les besoins. Pour plus d'informations sur la modification d'une classe à l'aide d'attributs, consultez Contrôle de la sérialisation XML à l'aide d'attributs et Attributs qui contrôlent la sérialisation XML.

Il est souvent utile d'examiner le schéma du flux XML qui est généré lorsque des instances d'une classe (ou classes) sont sérialisées. Par exemple, vous pouvez publier votre schéma à l'attention d'autres utilisateurs, ou vous pouvez le comparer à un schéma dont vous cherchez à respecter la conformité.

Pour générer un document de schéma XML à partir d'un ensemble de classes.

  1. Compilez la classe ou les classes dans une DLL.

  2. Ouvrez une fenêtre d'invite de commandes.

  3. Passez la DLL sous la forme d'un argument à l'exécutable Xsd.exe. Par exemple :

    xsd MyFile.dll

    Le schéma (ou schémas) sera écrit en commençant par le nom « schema0.xsd ».

Voir aussi

Introduction à la sérialisation XML | DataSet | Outil XML Schema Definition Tool (Xsd.exe) | XmlSerializer