Warning, tâche

Mise à jour : novembre 2007

Enregistre un avertissement lors d'une génération selon une instruction conditionnelle évaluée.

Paramètres

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

Paramètres

Description

Code

Paramètre String facultatif.

Code d'avertissement à associer à l'avertissement.

HelpKeyword

Paramètre String facultatif.

Mot clé Help à associer à l'avertissement.

Text

Paramètre String facultatif.

Texte d'avertissement que MSBuild enregistre si le paramètre Condition a la valeur true.

Notes

La tâche Warning permet aux projets MSBuild de vérifier la présence d'une configuration ou d'une propriété requise avant de passer à l'étape de génération suivante.

Si le paramètre Condition de la tâche Warning a la valeur true, la valeur de l'attribut Text est enregistrée dans un journal et la génération se poursuit. Si un paramètre Condition n'existe pas, le texte d'avertissement est enregistré dans un journal. Pour plus d'informations sur la journalisation, consultez Vue d'ensemble de la journalisation dans MSBuild.

Exemple

L'exemple de code suivant vérifie les propriétés définies dans la ligne de commande. En l'absence de propriétés définies, le projet déclenche un événement d'avertissement et enregistre la valeur du paramètre Text de la tâche Warning dans un journal.

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

Voir aussi

Concepts

Vue d'ensemble de la journalisation dans MSBuild

Référence du schéma de fichier de projet MSBuild