Error Task

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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

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

ParamètreDescription
CodeParamètre String facultatif.

Code d'erreur à associer à l'erreur.
FileParamètre String facultatif.

Nom du fichier qui contient l'erreur. Si aucun nom de fichier n'est fourni, le fichier qui contient la tâche d'erreur (Error) sera utilisé.
HelpKeywordParamètre String facultatif.

Mot clé d'aide à associer à l'erreur.
TextParamètre String facultatif.

Texte d'erreur enregistré par MSBuild si le paramètre Condition prend la valeur true.

La tâche Error permet aux projets MSBuild d'envoyer le texte d'erreur aux enregistreurs d'événements 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 Obtention de journaux de génération.

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 TaskExtension Base Class.

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="http://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>  

Task Reference
Obtention de journaux de génération

Afficher: