Compartir a través de


La herramienta Definición de esquemas XML y serialización XML

La herramienta Definición de esquemas XML (Xsd.exe) se instala junto con las herramientas de .NET Framework como parte de .NET Framework SDK. La herramienta está diseñada principalmente para dos fines:

  • Generar archivos de clases de C# o de Visual Basic que se ajusten a un esquema específico de lenguaje de definición de esquemas XML (XSD). La herramienta acepta un esquema XML como argumento y genera un archivo con una serie de clases que, cuando se serializa con XmlSerializer, se ajustan al esquema.
  • Generar un documento de esquema XML a partir de un archivo .dll o .exe. Si necesita ver el esquema de un conjunto de archivos que ha creado o que se ha modificado con atributos, pase el archivo DLL o EXE como argumento a la herramienta a fin de generar el esquema XML.

Para obtener información detallada de ésta y de otras herramientas, vea Herramientas de .NET Framework. Para obtener información detallada acerca de las opciones de las herramientas, vea la herramienta Definición de esquemas XML (Xsd.exe).

Para generar clases que se ajusten a un esquema específico

  1. Abra una ventana del símbolo del sistema.

  2. Pase el esquema como argumento a la herramienta de definición de esquemas XML, que crea un conjunto de clases que coinciden exactamente con el esquema XML. Por ejemplo:

    xsd mySchema.xsd
    

    La herramienta sólo puede procesar esquemas que hagan referencia a la especificación XML del W3C (World Wide Web Consortium) del 16 de marzo de 2001. En otras palabras, el espacio de nombres del esquema XML debe ser "http://www.w3.org/2001/XMLSchema", como se muestra en el ejemplo siguiente.

    <?xml version="1.0" encoding="utf-8"?>
    <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    
  3. Modifique las clases mediante métodos, propiedades o campos, como corresponda. Para obtener más información sobre cómo modificar una clase con atributos, vea Controlar la serialización XML mediante atributos y Atributos que controlan la serialización XML.

A menudo resulta útil examinar el esquema de la secuencia XML generada cuando se serializan instancias de una o varias clases. Por ejemplo, podría publicar el esquema para que lo utilicen otros o bien compararlo con un esquema con el que intente conseguir conformidad.

Para generar un documento de esquema XML a partir de un conjunto de clases

  1. Compile las clases en un archivo DLL.

  2. Abra una ventana del símbolo del sistema.

  3. Pase el archivo DLL como un argumento de Xsd.exe. Por ejemplo:

    xsd MyFile.dll
    

    Los esquemas se escribirán empezando por el nombre "schema0.xsd".

Vea también

Presentar la serialización XML | DataSet | Herramienta Definición de esquemas XML (Xsd.exe) | XmlSerializer