Compartilhar via


Tarefa de aviso

Logs um aviso durante uma compilação com base em uma instrução condicional avaliada.

Parâmetros

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

Parâmetro

Descrição

Code

Opcional String parâmetro.

O código de aviso para associar o aviso.

File

Opcional String parâmetro.

Especifica o arquivo relevante, se houver.Se nenhum arquivo for fornecido, o arquivo que contém a tarefa de aviso é usado.

HelpKeyword

Opcional String parâmetro.

A Ajuda palavra-chave para associar o aviso.

Text

Opcional String parâmetro.

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

Comentários

O Warning tarefa permite que MSBuild projetos para verificar a presença de uma configuração necessária ou a propriedade antes de prosseguir com a próxima etapa de compilação.

Se a Condition parâmetro da Warning tarefa é avaliada como true, o valor da Text parâmetro é registrado e a compilação continua a executar.Se um Condition parâmetro faz não exisit, o texto de aviso é registrado.Para obter mais informações sobre o registro em log, consulte Obtendo logs de compilação com o MSBuild.

Com os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension herda de classe, que por si só a Task classe.Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base TaskExtension.

Exemplo

O exemplo de código a seguir verifica as propriedades que são definidas na linha de comando.Se não houver nenhum conjunto de propriedades, o projeto dispara um evento de aviso e registra o valor da Text parâmetro da Warning tarefa.

<Project xmlns="https://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>

Consulte também

Conceitos

Obtendo logs de compilação com o MSBuild

Referência de esquema do arquivo de projeto MSBuild