Avertissement (tâche)Warning task

Enregistre un avertissement durant une génération en fonction d’une instruction conditionnelle évaluée.Logs a warning during a build based on an evaluated conditional statement.

ParamètresParameters

Le tableau ci-dessous décrit les paramètres de la tâche Warning .The following table describes the parameters of the Warning task.

ParamètreParameter DescriptionDescription
Code Paramètre String facultatif.Optional String parameter.

Code d’avertissement à associer à l’avertissement.The warning code to associate with the warning.
File Paramètre String facultatif.Optional String parameter.

Spécifie le fichier approprié, le cas échéant.Specifies the relevant file, if any. Si aucun fichier n’est fourni, le fichier qui contient la tâche d’avertissement (Warning) est utilisé.If no file is provided, the file containing the Warning task is used.
HelpKeyword Paramètre String facultatif.Optional String parameter.

Mot clé d’aide à associer à l’avertissement.The Help keyword to associate with the warning.
Text Paramètre String facultatif.Optional String parameter.

Texte d’avertissement que MSBuildMSBuild journalise si le paramètre Condition a la valeur true.The warning text that MSBuildMSBuild logs if the Condition parameter evaluates to true.

NotesRemarks

La tâche Warning permet aux projets MSBuildMSBuild de vérifier la présence d’une configuration requise ou d’une propriété obligatoire avant de passer à l’étape de génération suivante.The Warning task allows MSBuildMSBuild projects to check for the presence of a required configuration or property before proceeding with the next build step.

Si le paramètre Condition de la tâche Warning a la valeur true, la valeur du paramètre Text est journalisée et la génération se poursuit.If the Condition parameter of the Warning task evaluates to true, the value of the Text parameter is logged and the build continues to execute. Si aucun paramètre Condition n’existe, le texte de l’avertissement est journalisé.If a Condition parameter does not exist, the warning text is logged. Pour plus d’informations sur la journalisation, voir Obtenir des journaux de génération.For more information on logging, see Obtain build logs.

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui elle-même hérite de la classe Task.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.For a list of these additional parameters and their descriptions, see TaskExtension base class.

ExempleExample

L’exemple de code suivant vérifie les propriétés définies sur la ligne de commande.The following code example checks for properties that are set on the command line. Si aucune propriété n’est définie, le projet déclenche un événement d’avertissement et journalise la valeur du paramètre Text de la tâche Warning.If there are no properties set, the project raises a warning event, and logs the value of the Text parameter of the Warning task.

<Project xmlns="http://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 aussiSee also

Obtenir des journaux de génération Obtain build logs
Informations de référence sur le schéma de fichier projetProject file schema reference