Warning, tâche
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ètre |
Description |
|---|---|
Code |
Paramètre String facultatif. Code d'avertissement à associer à l'avertissement. |
File |
Paramètre String facultatif. Spécifie le fichier pertinent, le cas échéant. Si aucun fichier n'est fourni, le fichier qui contient la tâche d'avertissement (Warning) est utilisé. |
HelpKeyword |
Paramètre String facultatif. Mot clé d'aide à associer à l'avertissement. |
Text |
Paramètre String facultatif. Texte d'avertissement enregistré par MSBuild si le paramètre Condition prend la valeur true. |
Notes
La tâche Warning permet aux projets MSBuild de rechercher 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 Obtention de journaux de génération avec MSBuild.
En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui hérite elle-même de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez Classe TaskExtension Base.
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>