Compartilhar via


Erro de tarefa

Interrompe um compilação e registra um erro com base em uma demonstrativo condicional avaliada.

Parâmetros

A tabela a seguir descreve os parâmetros do Error tarefa.

Parâmetro

Descrição

Code

Opcional String parâmetro.

O código de erro para associar o erro.

HelpKeyword

Opcional String parâmetro.

A palavra-chave de ajuda para associar o erro.

Text

Opcional String parâmetro.

O texto do erro que MSBuild registra se o Condition parâmetro é avaliada como true.

Comentários

The Error tarefa permite MSBuild projetos emitem texto de erro para agentes de log e interromper a execução de compilação.

Se o Condition parâmetro é avaliada como true, a compilação é interrompida e um erro será registrado. If a Condition parâmetro não existe, o erro é registrado e criar paradas de execução. Para obter mais informações sobre o logon, consulte Visão geral do log no MSBuild.

Exemplo

O exemplo de código a seguir verifica se todas as propriedades obrigatórias estão conjunto. Se eles não estiverem definidos, o projeto gera um evento de erro e registra o valor de Text parâmetro das Error tarefa.

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

Consulte também

Conceitos

Visão geral do log no MSBuild

Outros recursos

Referência de tarefa do MSBuild