Receta C# No. 6-10: Cómo Crear un Esquema para una Clase de .NET

Índice

1. Introducción
2. Palabras Clave
3. Problema
4. Solución
5. Discusión de la Solución
5.1 XML Schema Definition Tool
6. Práctica: Creación de Esquema con xsd.exe
6.1 Esquema de CatalagoProductos2007.xml
6.2 Esquema de CatalogoProductos.dll
7. Conclusiones
8. Literatura & Enlaces

1. Introducción

.NET Framework cuenta con la herramienta de generación de esquemas a partir documentos XML y assemblies .NET xsd.exe (XML Scheme Definition Tool). Esta utilidad está basada en línea de comandos. En esta receta se describe su uso, y se recurre al uso de las recetas C# 6-8 y 6-8 para realizar ejemplos prácticos para generar esquemas usando esta herramienta.

2. Palabras Clave

• Esquema
• XML
• XSD

3. Problema

Generar esquema de un documento XML a partir de una clase de .NET.

4. Solución

.NET Framework cuenta con la herramienta de línea de comandos para la generación de esquema de documento XML xsd.exe -XML Schema Definition Tool-.

5. Discusión de la Solución

5.1 XML Schema Definition Tool

La herramienta de generación de esquemas xsd.exe permite al programador generar un esquema de XML a partir de un assembly de .NET.

Su uso básico comprende 

xsd.exe /t:[NombreTipoDato]

Otras opciones de salida pueden ser especificadas ("XML Schema Definition Tool", 2016); como:

• /h[elp]: Descripción de la sintaxis de uso.
• /o[utputdir]:directorio: Ruta de salida del archivo de esquema.
• /?: Descripción de la sintaxis de uso.
• P[arameters]:file.xml: Lectura de archivo XML para distintos modos de operación.

Además brinda soporte para otras fuentes como:

• XML, 
• XDR

6. Práctica: Creación de Esquema con xsd.exe

Este ejemplo usa el archivo CatalogoProductos.xml de Receta C# No. 6-8: Cómo Validar un Documento XML con un Esquema y CatalogoProductos.dll de Receta C# No. 6-9: Cómo Usar Serialización XML con Objetos Personalizados para generar los esquemas correspondientes.

6.1 Esquema de CatalogoProductos2017.xml

xsd.exe CatalogoProductos2017.xml

Este es el esquema resultante:

Archivo XSD CatalogoProductos2017.xsd [Enlace alternativo]:

6.2 Esquema de CatalogoProductos.dll

xsd CatalogoProductos.dll

De este assembly se produce el siguiente esquema:

Archivo XSD schema0.xsd [Enlace alternativo]:

Estos dos archivos XSD generados pueden ser validados con la aplicación consola creada en Receta C# No. 6-8: Cómo Validar un Documento XML con un Esquema.

7. Conclusiones

Se enseñó cómo a través de la herramienta xsd.exe es posible generar los esquemas tanto de un documento XML como de un assembly. Su funcionalidad permite al programador validar documentos 

En la próxima receta C# se usará un esquema para la generación de una clase.

8. Literatura & Enlaces

Jones, A., Freeman (2010). Visual C# 2010 Recipes: A Problem-Solution Approach. United States: Apress.
XML Schema Definition Tool (Xsd.exe) (2016, junio 10). Recuerdo desde: https://msdn.microsoft.com/en-us/library/x6c1kb0s(v=vs.110).aspx
Receta C# No. 6-8: Cómo Validar un Documento XML con un Esquema (2016, junio 10). Recuperado desde: http://ortizol.blogspot.com/2016/06/receta-csharp-no-6-8-como-validar-un-documento-xml-con-un-esquema.html
Receta C# No. 6-9: Cómo Usar Serialización XML con Objetos Personalizados (2016, junio 10). Recuperado desde: http://ortizol.blogspot.com/2016/06/receta-csharp-no-6-9-como-usar-serializacion-xml-con-objetos-personalizados.html

V