Herramienta Generador de serializador XML (Sgen.exe)
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]:filename |
Genera código de serialización para todos los tipos del ensamblado o la aplicación ejecutable que especifica filename. Sólo se puede proporcionar un nombre de archivo. Si se repite este argumento, se utilizará el último nombre. |
/c[ompiler]: options |
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 or /? |
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]:path |
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]:assemblyfiles |
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]:type |
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.
Vea también
Referencia
Herramientas de .NET Framework
Símbolo del sistema de SDK