Partager via

Message (tâche)

  • Article

Enregistre un message pendant une génération.

Paramètres

Le tableau ci-dessous décrit les paramètres de la tâche Message .

Paramètre Description
Importance Paramètre String facultatif.

Spécifie l’importance du message. Ce paramètre peut avoir la valeur high, normal ou low. La valeur par défaut est normal.
Text Paramètre String facultatif.

Texte d’erreur à consigner.

Notes

La tâche Message permet aux projets MSBuild d’envoyer des messages à des enregistreurs d’événements à différentes étapes du processus de génération.

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. Si un paramètre Condition n’existe pas, le texte du message est consigné dans le journal. Pour plus d’informations sur la journalisation, voir Obtenir des journaux de génération.

Par défaut, le message est envoyé à tous les enregistreurs d’événements inscrits. L’enregistreur d’événements interprète le paramètre Importance. En règle générale, un message ayant la valeur high est envoyé quand le niveau de détail de l’enregistreur d’événements a la valeur LoggerVerbosity.Minimal ou plus. Un message ayant la valeur low est envoyé quand le niveau de détail de l’enregistreur d’événements a la valeur LoggerVerbosity.Detailed.

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 . Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.

Exemple

L’exemple de code suivant consigne les messages dans tous les enregistreurs d’événements inscrits.

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