tarefa Warning

  • Artigo

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

Parâmetros

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

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

O código de erro que será associado ao aviso.
File Parâmetro String opcional.

Especifica o arquivo relevante, se houver. Se nenhum arquivo for fornecido, o arquivo que contém a tarefa de aviso será usado.
HelpKeyword Parâmetro String opcional.

A palavra-chave Ajuda que será associada ao aviso. Apenas para uso interno.
HelpLink Parâmetro String opcional.

Um link para obter mais informações sobre esse aviso.
Text Parâmetro String opcional.

O texto de aviso que que o MSBuild registra se o parâmetro Condition resultar em true.

Comentários

A tarefa Warning permite que projetos MSBuild verifiquem a presença de uma configuração necessária ou propriedade antes de continuar com a próxima etapa de build.

Se o parâmetro Condition da tarefa Warning for avaliada como true, o valor do parâmetro Text será registrado e o build continuará a ser executada. Se não existir um parâmetro Condition, o texto de aviso será registrado. Para saber mais sobre o log, confira Obter logs de build.

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, confira Classe base TaskExtension.

HelpKeyword é usado pelo Visual Studio para dar suporte ao recurso de ajuda contextual (F1). Você pode usar HelpLink para associar uma página de ajuda online a uma mensagem de erro.

Exemplo

O exemplo de código a seguir verifica as propriedades que são definidas na linha de comando. Se nenhuma propriedade estiver definida, o projeto gerará um evento de aviso e registrará o valor do parâmetro Text da tarefa Warning.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="ValidateCommandLine">
        <Warning
            Text=" The 0 property was not set on the command line."
            Condition="'$(0)' == ''" />
        <Warning
            Text=" The FREEBUILD property was not set on the command line."
            Condition="'$(FREEBUILD)' == ''" />
    </Target>
    ...
</Project>

Confira também