SGen (tarea)
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. |