Referência de tarefas do MSBuild

  • Artigo

Tarefas fornecem o código que é executado durante o processo de build. As tarefas na lista a seguir são incluídas com o MSBuild. Quando a carga de trabalho do C++ é instalada, há tarefas adicionais disponíveis, que são usadas para compilar projetos em C++. Para obter mais informações, confira Tarefas do C++.

Além dos parâmetros listados nos tópicos nesta seção, cada tarefa também tem os parâmetros a seguir:

Parâmetro Descrição
Condition Parâmetro String opcional.

A expressão Boolean que o mecanismo MSBuild usa para determinar se essa tarefa será executada. Para obter informações sobre as condições que são suportadas pelo MSBuild, confira Condições.
ContinueOnError Parâmetro opcional. Pode conter um dos seguintes valores:

- WarnAndContinue ou true. Quando uma tarefa falha, as tarefas subsequentes no elemento de Destino e o build continuam em execução e todos os erros da tarefa são tratados como avisos.
- ErrorAndContinue. Quando uma tarefa falha, as tarefas subsequentes no elemento de Target e o build continuam em execução e todos os erros da tarefa são tratados como erros.
- ErrorAndStop ou false (padrão). Quando uma tarefa falha, as tarefas restantes do elemento de Target e o build não são executadas e todo o elemento de Target e o build são considerados como em falha.

As versões do .NET Framework antes da 4.5 ofereciam suporte somente aos valores true e false.

Para saber mais, confira Como ignorar erros em tarefas.

Nesta seção

Adiciona vários parâmetros para as tarefas que derivam da classe Task. Não se destina a ser usado diretamente.

Adiciona vários parâmetros para as tarefas que derivam da classe TaskExtension. Não se destina a ser usado diretamente.

Adiciona vários parâmetros para as tarefas que derivam da classe ToolTaskExtension. Não se destina a ser usado diretamente.

Cria um assembly com um manifesto com base em um ou mais arquivos que são arquivos de recurso ou módulos.

Encapsula aspnet_compiler.exe, um utilitário para pré-compilar aplicativos ASP.NET.

Atribui os identificadores de cultura a itens.

Aceita uma lista de cadeias de caracteres de configuração e as atribui a projetos especificados.

Aceita uma lista de arquivos e adiciona atributos <TargetPath> se eles ainda não foram especificados.

Invoca um destino no arquivo de projeto.

Combina os caminhos especificados em um único caminho.

Converte uma referência ou caminho relativo em um caminho absoluto.

Copia os arquivos para um novo local.

Cria um nome de manifesto em estilo C# com base em um nome de arquivo .resx fornecido ou em outro recurso.

Popula as coleções de itens dos itens de entrada, permitindo que os itens sejam copiados de uma lista para outra.

Popula as propriedades de valores de entrada, permitindo que os valores sejam copiados de uma propriedade ou cadeia de caracteres para outra.

Cria um nome de manifesto em estilo Visual Basic com base em um nome de arquivo .resx fornecido ou em outro recurso.

Chama o Compilador do Visual C# para produzir arquivos executáveis, bibliotecas de vínculo dinâmico ou módulos de código.

Exclui os arquivos especificados.

Baixa um arquivo no local especificado.

Interrompe um build e registra um erro com base em uma instrução condicional avaliada.

Executa o programa ou comando especificado com os argumentos especificados.

Localiza o arquivo app.config, caso haja algum, nas listas fornecidas.

Localiza um item em uma lista especificada com o itemspec correspondente.

Determina quais itens na coleção de itens especificados existem na pasta especificada ou suas subpastas.

Converte uma URL em um formato de URL correto.

Acrescenta o número de revisão ao número de versão.

Gera um manifesto nativo ou um manifesto do aplicativo ClickOnce.

Fornece uma forma automatizada de detectar, baixar e instalar um aplicativo e seus pré-requisitos.

Gera um manifesto de implantação do ClickOnce.

Converte arquivos .txt e .resx em arquivos .resources binários do Common Language Runtime.

Gera a confiança do aplicativo do manifesto base e dos parâmetros TargetZone e ExcludedPermissions.

Recupera as identidades do assembly dos arquivos especificados e gera como saída as informações de identidade.

Calcula as somas de verificação do conteúdo de um arquivo ou conjunto de arquivos.

Recupera o caminho para os assemblies .NET Framework.

Recupera o caminho para o SDK (Software Development Kit) do Windows.

Retorna os caminhos do assembly de referência de diversas estruturas.

Gera um arquivo .license de um arquivo .licx.

Cria diretórios e, se necessário, qualquer diretório pai.

Registra uma mensagem durante a compilação.

Move os arquivos para um novo local.

Compila projetos do MSBuild de outro projeto do MSBuild.

Lê uma lista de itens de um arquivo de texto.

Lê os metadados dentro do assembly especificado e adiciona as entradas necessárias ao Registro.

Remove os diretórios especificados e todos os seus arquivos e subdiretórios.

Remove itens duplicados da coleção do item especificado.

Determina se o aplicativo requer o .NET Framework 3.5 SP1.

  • Tarefa ResGen

Obsoleto. Use a Tarefa GenerateResource para converter arquivos .txt e .resx em arquivos .resources binários do Common Language Runtime.

Determina todos os assemblies que dependem dos assemblies especificados.

Obtém uma lista de um ou mais nomes de bibliotecas de tipo ou arquivos .tlb e resolve essas bibliotecas de tipo em locais no disco.

Determina a origem da chave de nome forte

Resolve os seguintes itens no processo de build para arquivos de geração de manifesto: itens compilados, dependências, satélites, conteúdo, símbolos de depuração e documentação.

Resolve referências nativas.

Determina os arquivos de saída para referências de projeto não MSBuild.

Cria um assembly de serialização de XML para tipos no assembly especificado.

Assina o arquivo especificado usando o certificado especificado.

Define os horários de modificação e acesso aos arquivos.

Cancela o registro os assemblies especificados para fins de interoperabilidade COM.

Descompacta um arquivo .zip no local especificado.

Atualiza as propriedades selecionadas em um manifesto e assina-as novamente.

Invoca o compilador do Visual Basic para produzir arquivos executáveis, bibliotecas de vínculo dinâmico ou módulos de código.

Verifica se um arquivo corresponde ao hash do arquivo esperado.

Registra um aviso durante um build com base em uma instrução condicional avaliada.

Gera um arquivo de código temporário pelo uso do fragmento de código gerado especificado. Não exclui o arquivo.

Grava os itens especificados no arquivo de texto especificado.

Retorna os valores conforme especificado por uma consulta de XPath em um arquivo XML.

Define os valores conforme especificado por uma consulta de XPath em um arquivo XML.

Transformações um XML de entrada usando um XSLT (linguagem XSL Transformation) ou XSLT compilado e saídas para um arquivo ou um dispositivo de saída.

Cria um arquivo .zip do conteúdo de um diretório.

Confira também