Share via

Error, tâche

  • Article

Mise à jour : novembre 2007

Arrête une génération et enregistre une erreur basée sur une instruction conditionnelle évaluée.

Paramètres

Le tableau suivant décrit les paramètres de la tâche Error.

Paramètres

Description

Code

Paramètre String facultatif.

Code d'erreur à associer à l'erreur.

HelpKeyword

Paramètre String facultatif.

Mot clé Help à associer à l'erreur.

Text

Paramètre String facultatif.

Texte d'erreur que MSBuild enregistre dans un journal si le paramètre Condition a la valeur true.

Notes

La tâche Error permet aux projets MSBuild de publier un texte d'erreur dans des journaux et d'arrêter l'exécution de la génération.

Si le paramètre Condition a la valeur true, la génération s'arrête et une erreur est enregistrée. S'il n'existe pas de paramètre Condition, l'erreur est enregistrée et arrête l'exécution de la génération. Pour plus d'informations sur la journalisation, consultez Vue d'ensemble de la journalisation dans MSBuild.

Exemple

L'exemple de code suivant vérifie que toutes les propriétés requises sont définies. Si ce n'est pas le cas, le projet génère un événement d'erreur et enregistre la valeur du paramètre Text de la tâche Error dans un journal.

<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>

Voir aussi

Concepts

Vue d'ensemble de la journalisation dans MSBuild

Autres ressources

Référence des tâches MSBuild