Tarefa AspNetCompiler

  • Artigo

A tarefa AspNetCompiler encapsula aspnet_compiler.exe, um utilitário para pré-compilar aplicativos ASP.NET.

Parâmetros de tarefa

A tabela a seguir descreve os parâmetros da tarefa AspNetCompiler.

Parâmetro Descrição
AllowPartiallyTrustedCallers Parâmetro Boolean opcional.

Se esse parâmetro for true, o assembly de nome forte permitirá chamadores parcialmente confiáveis.
Clean Parâmetro opcional Boolean

Se esse parâmetro for true, o aplicativo pré-compilado será compilado limpo. Todos os componentes compilados anteriormente serão recompilados. O valor padrão é false. Esse parâmetro corresponde à opção -c do aspnet_compiler.exe.
Debug Parâmetro Boolean opcional.

Se esse parâmetro for true, informações de depuração (arquivo .PDB) serão emitidas durante o build. O valor padrão é false. Esse parâmetro corresponde à opção -d do aspnet_compiler.exe.
DelaySign Parâmetro Boolean opcional.

Se esse parâmetro for true, o assembly não será totalmente assinado quando for criado.
FixedNames Parâmetro Boolean opcional.

Se esse parâmetro for true, os assemblies compilados receberão nomes fixos.
Force Parâmetro opcional Boolean

Se esse parâmetro for true, a tarefa substituirá o diretório de destino se ele já existir. Os conteúdos existentes serão perdidos. O valor padrão é false. Esse parâmetro corresponde à opção -f do aspnet_compiler.exe.
KeyContainer Parâmetro String opcional.

Especifica um contêiner de chave de nome forte.
KeyFile Parâmetro String opcional.

Especifica o caminho físico do arquivo de chave de nome forte.
MetabasePath Parâmetro String opcional.

Especifica o caminho completo da metabase do IIS do aplicativo. Esse parâmetro não pode ser combinado com os parâmetros VirtualPath ou PhysicalPath. Esse parâmetro corresponde à opção -m do aspnet_compiler.exe.
PhysicalPath Parâmetro String opcional.

Especifica o caminho físico do aplicativo a ser compilado. Se esse parâmetro estiver ausente, a metabase do IIS será usada para localizar o aplicativo. Esse parâmetro corresponde à opção -p do aspnet_compiler.exe.
TargetFrameworkMoniker Parâmetro String opcional.

Especifica o TargetFrameworkMoniker que indica qual versão do .NET Framework do aspnet_compiler.exe deve ser usada. Aceita apenas monikers do .NET Framework.
TargetPath Parâmetro String opcional.

Especifica o caminho físico para o qual o aplicativo é compilado. Se não for especificado, o aplicativo será pré-compilado no local.
Updateable Parâmetro Boolean opcional.

Se esse parâmetro for true, o aplicativo pré-compilado será atualizável. O valor padrão é false. Esse parâmetro corresponde à opção -u do aspnet_compiler.exe.
VirtualPath Parâmetro String opcional.

Especifica o caminho virtual do aplicativo a ser compilado. Se PhysicalPath for especificado, o caminho físico será usado para localizar o aplicativo. Caso contrário, a metabase do IIS será usada e será considerado que o aplicativo está no site padrão. Esse parâmetro corresponde à opção -v do aspnet_compiler.exe.

Parâmetros de ToolTaskExtension

Essa tarefa herda da classe ToolTaskExtension, que herda da classe ToolTask, que por sua vez herda da classe Task. Esta cadeia de herança adiciona vários parâmetros nas tarefas que derivam deles.

A seguinte tabela descreve os parâmetros das classes base:

Parâmetro Descrição
EchoOff Parâmetro bool opcional.

Quando definido como true, essa tarefa passa /Q para a linha de comando de cmd.exe, de modo que a linha de comando não é copiada para stdout.
EnvironmentVariables Parâmetro de matriz String opcional.

Matriz de definições da variável de ambiente, separadas por ponto e vírgula. Cada definição deve especificar um nome da variável de ambiente e um valor separados por um sinal de igual. Essas variáveis são passadas para o executável gerado além, ou seletivamente substituindo, o bloco de ambiente regular. Por exemplo, Variable1=Value1;Variable2=Value2.
ExitCode Parâmetro de saída opcional somente leitura Int32.

Especifica o código de saída fornecido pelo comando executado. Se a tarefa registra erros, mas o processo tem um código de saída de 0 (êxito), isso é definido como -1.
LogStandardErrorAsError Parâmetro bool opcional.

Se true, todas as mensagens recebidas no fluxo de erro padrão são registradas como erros.
StandardErrorImportance Parâmetro String opcional.

a importância com a qual o texto do fluxo de erro padrão deve ser registrado.
StandardOutputImportance Parâmetro String opcional.

Importância para fazer o texto de log do fluxo de saída do padrão.
Timeout Parâmetro Int32 opcional.

Especifica a quantidade de tempo em milissegundos após o qual o executável da tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há período de tempo limite. O tempo limite está em milissegundos.
ToolExe Parâmetro string opcional.

Projetos podem implementar para substituir um ToolName. Tarefas podem substituir isso para preservar o ToolName.
ToolPath Parâmetro string opcional.

Especifica o local de onde a tarefa carrega o arquivo executável subjacente. Se esse parâmetro não for especificado, a tarefa usará o caminho de instalação do SDK correspondente à versão da estrutura que está executando o MSBuild.
UseCommandProcessor Parâmetro bool opcional.

Quando definido como true, essa tarefa cria um arquivo em lotes para a linha de comando e o executa usando o processador de comando em vez de executar o comando diretamente.
YieldDuringToolExecution Parâmetro bool opcional.

Quando definido como true, essa tarefa gera o nó quando a tarefa está em execução.

Exemplo

O exemplo de código a seguir usa a tarefa AspNetCompiler para pré-compilar um aplicativo 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>

Confira também