Message-Aufgabe
Protokolliert eine Meldung während eines Builds.
Parameter
In der folgenden Tabelle werden die Parameter der Message-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
Importance |
Optionaler String-Parameter. Gibt die Wichtigkeit der Meldung an. Dieser Parameter kann den Wert high, normal oder low aufweisen. Der Standardwert ist normal. |
Text |
Optionaler String-Parameter. Der zu protokollierende Fehlertext. |
Hinweise
Die Message-Aufgabe ermöglicht es MSBuild-Projekten, bei verschiedenen Schritten im Buildprozess Meldungen an Protokollierungen auszugeben.
Wenn der Condition-Parameter true ergibt, wird der Wert des Text-Parameters protokolliert und der Buildprozess fortgesetzt. Wenn kein Condition-Parameter vorhanden ist, wird der Meldungstext protokolliert. Weitere Informationen zur Protokollierung finden Sie unter Übersicht über die Protokollierung in MSBuild.
Standardmäßig wird die Nachricht an die MSBuild-Konsolenprotokollierung gesendet. Dies kann geändert werden, indem der Parameter Log festgelegt wird. Die Protokollierung interpretiert den Parameter Importance.
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.
Beispiel
Im folgenden Codebeispiel werden Meldungen an alle registrierten Protokollierungen protokolliert.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<Target Name="DisplayMessages">
<Message Text="Project File Name = $(MSBuildProjectFile)" />
<Message Text="Project Extension = $(MSBuildProjectExtension)" />
</Target>
...
</Project>
Siehe auch
Konzepte
Übersicht über die Protokollierung in MSBuild