LC (tarea)

  • Artículo

Incluye LC.exe, que genera un archivo .license a partir de un archivo .licx. Para obtener más información sobre LC.exe, vea Lc.exe (Compilador de licencias).

Parámetros

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

Parámetro Descripción
LicenseTarget Parámetro ITaskItem requerido.

Especifica el archivo ejecutable para el que se generan los archivos .licenses.
NoLogo Parámetro Boolean opcional.

Suprime la presentación de la portada de inicio de Microsoft.
OutputDirectory Parámetro String opcional.

Especifica el directorio en el que se colocan los archivos .licenses de salida.
OutputLicense Parámetro de salida ITaskItem opcional.

Especifica el nombre de los archivos .licenses. Si no especifica un nombre, se usa el nombre del archivo .licx y el archivo .licenses se coloca en el directorio que contiene el archivo .licx.
ReferencedAssemblies Parámetro ITaskItem[] opcional.

Especifica los componentes a los que se hace referencia que se van a cargar al generar el archivo .license.
SdkToolsPath Parámetro String opcional.

Especifica la ruta de acceso a las herramientas del SDK, como resgen.exe.
Sources Parámetro ITaskItem[] requerido.

Especifica los elementos que contienen los componentes con licencia que se van a incluir en el archivo .licenses. Para obtener más información, consulte la documentación sobre el modificador /complist en Lc.exe (License Compiler).

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.

Ejemplo

En el siguiente ejemplo se utiliza la tarea LC para compilar las licencias.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!-- Item declarations, etc -->

    <Target Name="CompileLicenses">
        <LC
            Sources="@(LicxFile)"
            LicenseTarget="$(TargetFileName)"
            OutputDirectory="$(IntermediateOutputPath)"
            OutputLicenses="$(IntermediateOutputPath)$(TargetFileName).licenses"
            ReferencedAssemblies="@(ReferencePath);@(ReferenceDependencyPaths)">

            <Output
                TaskParameter="OutputLicenses"
                ItemName="CompiledLicenseFile"/>
        </LC>
    </Target>
</Project>

Vea también