Comment : utiliser l'outil XML Schema Definition pour générer des classes et des documents de schéma XML

  • Article

L'outil XML Schema Definition (Xsd.exe) vous permet de générer un schéma XML qui décrit une classe ou de générer la classe définie par un schéma XML. Les procédures suivantes indiquent comment exécuter ces opérations.

L’outil de définition de schéma XML (Xsd.exe) se trouve généralement dans le chemin suivant :
C:\Program Files (x86)\Microsoft SDKs\Windows\{version}\bin\NETFX {version} Tools\

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

  1. Ouvrez une invite de commandes.

  2. Passez par exemple le schéma XML en tant qu'argument à l'outil XML Schema Definition, qui crée un ensemble de classes correspondant précisément au schéma XML :

    xsd mySchema.xsd

    L'outil ne peut traiter que les schémas qui référencent la spécification XML du W3C (World Wide Web Consortium) du 16 mars 2001. Autrement dit, l'espace de noms du schéma XML doit être "http://www.w3.org/2001/XMLSchema", tel qu'illustré par 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 si nécessaire les classes avec les méthodes, les propriétés ou les champs. Pour plus d’informations sur la modification d’une classe avec des attributs, consultez Contrôle de la sérialisation XML à l’aide d’attributs et Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP.

Il est souvent utile d'examiner le schéma du flux de données XML généré lorsque les instances d'une ou de plusieurs classes sont sérialisées. Par exemple, vous pouvez publier votre schéma pour d'autres utilisateurs ou le comparer à un schéma auquel vous tentez de vous conformer.

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

  1. Compilez la ou les classes dans une DLL.

  2. Ouvrez une invite de commandes.

  3. Passez la DLL en tant qu'argument dans Xsd.exe, par exemple :

    xsd MyFile.dll

    Le ou les schémas sont écrits et commencent par le nom "schema0.xsd."

Voir aussi