Message, tâcheMessage Task

Enregistre un message pendant une génération.Logs a message during a build.

ParamètresParameters

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

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

Spécifie l’importance du message.Specifies the importance of the message. Ce paramètre peut avoir la valeur high, normal ou low.This parameter can have a value of high, normal or low. La valeur par défaut est normal.The default value is normal.
Text Paramètre String facultatif.Optional String parameter.

Texte d’erreur à consigner.The error text to log.

NotesRemarks

La tâche Message permet aux projets MSBuildMSBuild d’envoyer des messages à des enregistreurs d’événements à différentes étapes du processus de génération.The Message task allows MSBuildMSBuild projects to issue messages to loggers at different steps in the build process.

Si le paramètre Condition a la valeur true, la valeur du paramètre Text est consignée dans le journal et la génération se poursuit.If the Condition parameter evaluates to true, the value of the Text parameter will be logged and the build will continue to execute. Si un paramètre Condition n’existe pas, le texte du message est consigné dans le journal.If a Condition parameter does not exist, the message text is logged. Pour plus d’informations sur la journalisation, consultez l’article Obtention de journaux de génération avec MSBuild.For more information on logging, see Obtaining Build Logs.

Par défaut, le message est envoyé à l’enregistreur d’événements de la console MSBuild.By default, the message is sent to the MSBuild console logger. Ceci peut être modifié en définissant le paramètre Log.This can be changed by setting the Log parameter. L’enregistreur d’événements interprète le paramètre Importance.The logger interprets the Importance parameter.

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 TaskExtension Base Class.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

ExempleExample

L’exemple de code suivant consigne les messages dans tous les enregistreurs d’événements inscrits.The following code example logs messages to all registered loggers.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
    <Target Name="DisplayMessages">  
        <Message Text="Project File Name = $(MSBuildProjectFile)" />  
        <Message Text="Project Extension = $(MSBuildProjectExtension)" />  
    </Target>  
    ...  
</Project>  

Voir aussiSee Also

Référence des tâches Task Reference
Obtention de journaux de génération avec MSBuildObtaining Build Logs