Tarefa de erro
Pára um build e registra o erro baseado em uma instrução condicional avaliada.
Parâmetros
A tabela a seguir descreve os parâmetros da Error de tarefas.
Parâmetro |
Descrição |
|---|---|
Code |
Opcional String parâmetro. O código de erro para associar o erro. |
File |
Opcional String parâmetro. O nome do arquivo que contém o erro. Se nenhum nome de arquivo for fornecido, o arquivo que contém a tarefa de erro será usado. |
HelpKeyword |
Opcional String parâmetro. A palavra-ajuda chave para associar o erro. |
Text |
Opcional String parâmetro. O texto de erro que MSBuild registra se o Condition parâmetro é avaliada como true. |
Comentários
O Error tarefa permite que MSBuild emitem o texto de erro para registradores de projetos e parar a execução de compilação.
Se o Condition parâmetro é avaliada como true, a compilação é interrompida e um erro será registrado. Se um Condition parâmetro não existir, o erro é registrado e criar pára a execução. Para obter mais informações sobre o log, consulte Visão geral de registros do MSBuild.
Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension , a própria classe herda o Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de TaskExtension.
Exemplo
O exemplo de código a seguir verifica se todas as necessárias propriedades são definidas. Se não forem definidas, o projeto gera um evento de erro e registra o valor da Text parâmetro da Error de tarefas.
<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 de registros do MSBuild