Receta C# No. 6-11: Generar una Clase Desde un Esquema

Índice

1. Introducción
2. Palabras Clave
3. Problema
4. Solución
5. Discusión de la Solución
5.1 Uso de xsd.exe
6. Práctica: Generación de Clase desde Esquema
7. Conclusiones
8. Literatura & Enlaces

1. Introducción

La receta C# anterior -6-10- demostró cómo a través de la herramienta xsd.exe se genera el esquema para un assembly de .NET o documento XML; ahora, se aprovechará el esquema generado para la generación de una clase de .NET. Para este propósito se recurre de nuevo a la herramienta de línea de comandos xsd.exe.

2. Palabras Clave

• .NET
• Clase
• Documento XML
• Esquema
• Línea de comandos

3. Problema

Crear una clase de .NET a partir de un esquema.

4. Solución

La herramienta de línea de comandos xsd.exe (XML Schema Definition Tool) convierte un esquema en un tipo de dato para .NET.

5. Discusión de la Solución

5.1 Uso de xsd.exe

Esta utilidad forma parte del SDK de Microsoft. Para facilitar su uso se recomienda agregar la variable de entorno al sistema; la cual puede ser encontrada en:

C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools

(Las versiones de los elementos de esta ruta pueden variar en función de la configuración del sistema.)

En cuanto a uso para el caso que comprende, esta es su sintaxis:

xsd {NombreArchivoEsquema}.xsd /c

6. Práctica: Generación de Clase desde Esquema

Para este ejemplo se usará el esquema de CatalogoProductos.xsd (Receta C# No. 6-10: Cómo Crear un Esquema para una Clase de .NET):

Archivo XSD CatalogoProductos.xsd [Enlace alternativo]: 

Ahora desde la línea de comandos se ejecuta esta instrucción con la utilidad xsd.exe:

xsd .\CatalogoProductos.xsd /C

Entonces el resultado generado es el siguiente archivo de C#:

Archivo C# CatalogoProductos.cs [Enlace alternativo][Enlace alternativo]:

Aunque este archivo es mucho más extenso y su implementación más compleja que el presentado en Receta C# No. 6-9: Cómo Usar Serialización XML con Objetos Personalizados, constituye la más misma definición para el esquema XML en consideración.

7. Conclusiones

Se demostró cómo generar una clase .NET a partir de un esquema por medio de la herramienta xsd.exe. Esto resultará útil para construir los tipos de un dominio a partir de una definición desarrollada bajo esquemas XML.

En la próxima receta C# se explora el proceso de XSL Transform.

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 11). https://msdn.microsoft.com/en-us/library/x6c1kb0s(v=vs.110).aspx
Receta C# No. 6-10: Cómo Crear un Esquema para una Clase de .NET (2016, junio 11). Recuperado desde: http://ortizol.blogspot.com.co/2016/06/receta-csharp-no-6-10-como-crear-un-esquema-para-una-clase-de-dotnet.html
Receta C# No. 6-9: Cómo Usar Serialización XML con Objetos Personalizados (2016, junio 12). Recuperado desde: http://ortizol.blogspot.com.co/2016/06/receta-csharp-no-6-9-como-usar-serializacion-xml-con-objetos-personalizados.html

V