Meldungsaufgabe
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 Nachricht an. Dieser Parameter kann den Wert high , normal oder low haben. Der Standardwert ist normal . |
Text |
Optionaler String -Parameter.Der zu protokollierende Fehlertext. |
Hinweise
Die Aufgabe Message
ermöglicht es MSBuild-Projekten, in verschiedenen Schritten des Buildprozesses Nachrichten an die Protokollierungen auszugeben.
Wenn der Condition
-Parameter true
ergibt, wird der Wert des Text
-Parameters protokolliert und der Build weiter ausgeführt. Wenn kein Condition
-Parameter vorhanden ist, wird der Nachrichtentext protokolliert. Weitere Informationen zur Protokollierung finden Sie unter Erhalten von Buildprotokollen.
Standardmäßig wird die Nachricht an alle registrierten Protokollierungen gesendet. Die Protokollierung interpretiert den Importance
Parameter. In der Regel wird eine Nachricht, die auf den Wert high
festgelegt ist, gesendet, wenn die Ausführlichkeit der Protokollierung auf LoggerVerbosity. festgelegt ist.Minimal
oder höher. Eine Nachricht mit dem Wert low
wird gesendet, wenn die Ausführlichkeit der Protokollierung auf LoggerVerbosity.Detailed
festgelegt ist.
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 Nachrichten in allen registrierten Protokollierungen protokolliert.
<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>