SGen (tarea)

  • Artículo

Crea un ensamblado de serialización XML para los tipos del ensamblado especificado. Esta tarea ajusta la herramienta Generador de serializador XML (Sgen.exe). Para más información, consulte Herramienta Generador de serializador XML (Sgen.exe).

Parámetros

En la siguiente tabla se describen los parámetros de la tarea SGen .

Parámetro Descripción
BuildAssemblyName Parámetro String requerido.

Ensamblado para el que se debe generar código de serialización.
BuildAssemblyPath Parámetro String requerido.

Ruta de acceso al ensamblado para el que se debe generar código de serialización.
DelaySign Parámetro Boolean opcional.

Si true, especifica que solo quiere colocar la clave pública en el ensamblado. Si false, especifica que quiere un ensamblado completamente firmado.

Este parámetro no tiene ningún efecto a menos que se utilice con el parámetro KeyFile o KeyContainer.
KeyContainer Parámetro String opcional.

Especifica un contenedor que contiene un par de claves. De este modo, el ensamblado se firmará mediante la inserción de una clave pública en el manifiesto del ensamblado. La tarea firmará después el ensamblado final con la clave privada.
KeyFile Parámetro String opcional.

Especifica un par de claves o una clave pública que se usará para firmar un ensamblado. El compilador inserta la clave pública en el manifiesto del ensamblado y firma después el ensamblado final con la clave privada.
Platform Parámetro String opcional.

Obtiene o establece la plataforma de compilador utilizada para generar el ensamblado de salida. Este parámetro puede tener un valor de x86, x64 o anycpu. El valor predeterminado es anycpu.
References Parámetro String[] opcional.

Especifica los ensamblados a los que hacen referencia los tipos que requieren serialización XML.
SdkToolsPath Parámetro String opcional.

Especifica la ruta de acceso a las herramientas del SDK, tales como resgen.exe.
SerializationAssembly Parámetro de salida ITaskItem[] opcional.

Contiene el ensamblado de serialización generado.
SerializationAssemblyName Parámetro String opcional.

Especifica el nombre del ensamblado de serialización generado.
ShouldGenerateSerializer Parámetro Boolean requerido.

Si es true, la tarea SGen debe generar un ensamblado de serialización.
Timeout Parámetro Int32 opcional.

Especifica el tiempo en milisegundos después del cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue, que indica que no hay período de tiempo de espera.
ToolPath Parámetro String opcional.

Especifica la ubicación desde donde la tarea cargará el archivo ejecutable subyacente (sgen.exe). Si no se especifica este parámetro, la tarea usa la ruta de instalación del SDK que se corresponde con la versión de la plataforma que está ejecutando MSBuild.
Types Parámetro String[] opcional.

Obtiene o establece una lista de tipos específicos para los que generar código de serialización. SGen generará el código de serialización solo para esos tipos.
UseProxyTypes Parámetro Boolean requerido.

Si es true, la tarea SGen genera código de serialización únicamente para los tipos de proxy de servicios web XML.

Parámetros de ToolTaskExtension

Esta tarea hereda de la clase ToolTaskExtension, que hereda de la clase ToolTask, la cual, a su vez, hereda de la clase Task. Esta cadena de herencia agrega varios parámetros a las tareas que derivan de ellos.

En la siguiente tabla se describen los parámetros de las clases base:

Parámetro Descripción
EchoOff Parámetro bool opcional.

Cuando se establece en true, esta tarea pasa /Q a la línea de comandos cmd.exe de modo que la línea de comandos no se copia en stdout.
EnvironmentVariables Parámetro de matriz String opcional.

Matriz de definiciones de variables de entorno, separadas por punto y coma. Cada definición debe especificar un valor y un nombre para la variable de entorno separados por un signo igual. Estas variables se pasan al ejecutable generado y, además, pasan el bloque de entorno normal o lo invalidan de manera selectiva. Por ejemplo, Variable1=Value1;Variable2=Value2.
ExitCode Parámetro de solo lectura de salida Int32 opcional.

Especifica el código de salida proporcionado por el comando ejecutado. Si la tarea registró errores pero el proceso tenía un código de salida de 0 (correcto), se establece en -1.
LogStandardErrorAsError Parámetro bool opcional.

Si true, todos los mensajes recibidos en el flujo de error estándar se registran como errores.
StandardErrorImportance Parámetro String opcional.

Importancia con la que se va a registrar el texto de la secuencia de error estándar.
StandardOutputImportance Parámetro String opcional.

Importancia con la que se va a registrar el texto de la secuencia de salida estándar.
Timeout Parámetro Int32 opcional.

Especifica el tiempo en milisegundos después del cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue, que indica que no hay período de tiempo de espera. Tiempo de espera en milisegundos.
ToolExe Parámetro string opcional.

Los proyectos pueden implementarlo para invalidar ToolName. Las tareas pueden invalidarlo para conservar ToolName.
ToolPath Parámetro string opcional.

Especifica la ubicación desde donde la tarea carga el archivo ejecutable subyacente. Si no se especifica este parámetro, la tarea usa la ruta de instalación del SDK que se corresponde con la versión del marco de trabajo que está ejecutando MSBuild.
UseCommandProcessor Parámetro bool opcional.

Cuando se establece en true, esta tarea crea un archivo por lotes para la línea de comandos y lo ejecuta mediante el procesador de comandos, en lugar de ejecutar el comando directamente.
YieldDuringToolExecution Parámetro bool opcional.

Cuando se establece en true, esta tarea produce el nodo cuando se ejecuta la tarea.

Vea también