AspNetCompiler (tarea)

  • Artículo

La tarea AspNetCompiler incluye aspnet_compiler.exe, una utilidad para precompilar las aplicaciones de ASP.NET.

Parámetros de tareas

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

Parámetro Descripción
AllowPartiallyTrustedCallers Parámetro Boolean opcional.

Si este parámetro es true, el ensamblado de nombre seguro permitirá llamadores de confianza parcial.
Clean Parámetro Boolean opcional.

Si este parámetro es true, se compilará la aplicación precompilada limpia. Cualquier componente previamente compilado se volverá a compilar. El valor predeterminado es false. Este parámetro corresponde al modificador -c en aspnet_compiler.exe.
Debug Parámetro Boolean opcional.

Si este parámetro es true, se enviará información de depuración (archivo .PDB) durante la compilación. El valor predeterminado es false. Este parámetro corresponde al modificador -d en aspnet_compiler.exe.
DelaySign Parámetro Boolean opcional.

Si este parámetro es true, el ensamblado no se firma totalmente cuando se crea.
FixedNames Parámetro Boolean opcional.

Si este parámetro es true, a los ensamblados compilados se les darán nombres fijos.
Force Parámetro Boolean opcional.

Si este parámetro es true, la tarea sobrescribirá el directorio de destino si ya existe. El contenido existente se perderá. El valor predeterminado es false. Este parámetro corresponde al modificador -f en aspnet_compiler.exe.
KeyContainer Parámetro String opcional.

Especifica un contenedor de claves de nombre seguro.
KeyFile Parámetro String opcional.

Especifica la ruta de acceso física del archivo de clave con nombre seguro.
MetabasePath Parámetro String opcional.

Especifica la ruta completa de la metabase de IIS de la aplicación. Este parámetro no se puede combinar con los parámetros VirtualPath o PhysicalPath. Este parámetro corresponde al modificador -m en aspnet_compiler.exe.
PhysicalPath Parámetro String opcional.

Especifica la ruta de acceso física de la aplicación que se va a compilar. Si este parámetro falta, se utiliza la metabase de IIS se utiliza para buscar la aplicación. Este parámetro corresponde al modificador -p en aspnet_compiler.exe.
TargetFrameworkMoniker Parámetro String opcional.

Especifica el elemento TargetFrameworkMoniker que indica la versión de .NET Framework de aspnet_compiler.exe que se debe usar. Solo acepta los monikers de .NET Framework.
TargetPath Parámetro String opcional.

Especifica la ruta de acceso física a la aplicación que se va a compilar. Si no se especifica, la aplicación se vuelve a compilar in situ.
Updateable Parámetro Boolean opcional.

Si este parámetro es true, la aplicación precompilada se podrá actualizar. El valor predeterminado es false. Este parámetro corresponde al modificador -u en aspnet_compiler.exe.
VirtualPath Parámetro String opcional.

Ruta de acceso virtual de la aplicación que se va a compilar. Si se especifica PhysicalPath, la ruta de acceso física se utiliza para buscar la aplicación. En caso contrario, se utiliza la metabase de IIS y se supone que la aplicación se encuentra en el lugar predeterminado. Este parámetro corresponde al modificador -v en aspnet_compiler.exe.

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 de código se utiliza la tarea AspNetCompiler para precompilar una aplicación de ASP.NET.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="PrecompileWeb">
        <AspNetCompiler
            VirtualPath="/MyWebSite"
            PhysicalPath="c:\inetpub\wwwroot\MyWebSite\"
            TargetPath="c:\precompiledweb\MyWebSite\"
            Force="true"
            Debug="true"
        />
    </Target>
</Project>

Vea también