Herramienta Generador de serializador XML (Sgen.exe)

Artículo
10/07/2008

El Generador de serializador XML crea un ensamblado de serialización XML para los tipos de un ensamblado especificado a fin de mejorar el rendimiento en el inicio de XmlSerializer cuando serializa o deserializa objetos de los tipos especificados.

sgen [options]

Parámetros

Opción	Descripción
/a[ssembly]:nombre de archivo	Genera código de serialización para todos los tipos del ensamblado o la aplicación ejecutable especificada por nombre de archivo. Sólo se puede proporcionar un nombre de archivo. Si se repite este argumento, se utilizará el último nombre.
/c [ompiler]:opciones	Especifica las opciones que se deben pasar al compilador de C#. Todas las opciones de csc.exe se admiten tal como se pasan al compilador. Esto puede servir para especificar que se debería firmar el ensamblado, así como para especificar el archivo de clave.
/d[ebug]	Genera un imagen que se puede utilizar con un depurador.
/f[orce]	Exige que se sobrescriba un ensamblado existente que tenga el mismo nombre. El valor predeterminado es false.
/help o /?	Muestra la sintaxis de comandos y opciones para la herramienta.
/k[eep]	Suprime la eliminación de los archivos de código fuente generados y otros archivos temporales después de que se han compilado en el ensamblado de serialización. Puede servir para determinar si la herramienta genera código de serialización para un tipo determinado.
/n[ologo]	Suprime la presentación de la portada de inicio de Microsoft.
/o[ut]: la ruta dedel	Especifica el directorio en el que se debe guardar el ensamblado generado. Nota: El nombre del ensamblado generado está compuesto por el nombre del ensamblado de entrada y "xmlSerializers.dll".
/p[roxytypes]	Sólo se genera código de serialización para los tipos de proxy de servicio Web XML.
/r[eference]:aechivo de ensamblado	Especifica los ensamblados a los que hacen referencia los tipos que requieren serialización XML. Acepta varios archivos de ensamblado separados por comas.
/s[ilent]	Suprime la presentación de mensajes de aprobación.
/t[ype]:tipo	Sólo genera código de serialización para el tipo especificado.
/v[erbose]	Muestra resultados detallados para la depuración. Enumera tipos del ensamblado de destino que no se pueden serializar con XmlSerializer.
/?	Muestra la sintaxis de comandos y opciones para la herramienta.

Comentarios

Cuando no se utiliza el Generador de serializador XML, un objeto XmlSerializer genera código de serialización y un ensamblado de serialización para cada tipo siempre que se ejecuta una aplicación. Para mejorar el rendimiento del inicio de la serialización XML, utilice la herramienta Sgen.exe a fin de generar de antemano esos ensamblados. Estos ensamblados se podrán implementar después con la aplicación.

El Generador de serializador XML también puede mejorar el rendimiento de los clientes que utilizan proxy de servicio Web XML para comunicarse con los servidores, dado que no se verá afectado el rendimiento del proceso de serialización la primera vez que se carga el tipo.

Estos ensamblados generados no se pueden utilizar en el lado del servidor de un servicio Web. Esta herramienta sólo es para los clientes de servicios Web y escenarios de serialización manual.

Si el ensamblado que contiene el tipo que se debe serializar se denomina MyType.dll, el ensamblado de serialización asociado se denominará MyType.XmlSerializers.dll.

Ejemplos

Mediante el siguiente comando se crea un ensamblado denominado Data.XmlSerializers.dll para serializar todos los tipos que contiene el ensamblado denominado Data.dll.

sgen Data.dll

Se puede hacer referencia al ensamblado Data.XmlSerializers.dll desde código cuando se necesite serializar y deserializar los tipos en Data.dll.

Consulte también

Otros recursos

.NET Framework Tools
XML Web Services Overview
SDK Command Prompt