Warning-Aufgabe
Protokolliert eine Warnung während eines Buildvorgangs auf der Grundlage einer ausgewerteten Bedingungsanweisung.
Parameter
In der folgenden Tabelle werden die Parameter der Warning-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
Code |
Optionaler String-Parameter. Der der Warnung zuzuordnende Warncode. |
File |
Optionaler String-Parameter. Gibt die relevante Datei an, falls vorhanden. Wenn keine Datei angegeben ist, wird die Datei mit der Warning-Aufgabe verwendet. |
HelpKeyword |
Optionaler String-Parameter. Das der Warnung zuzuordnende Schlüsselwort der Hilfe. |
Text |
Optionaler String-Parameter. Der Warnungstext, den MSBuild protokolliert, wenn der Condition-Parameter true ergibt. |
Hinweise
Mithilfe der Warning-Aufgabe können MSBuild-Projekte vor der Ausführung des nächsten Buildschritts überprüfen, ob eine erforderliche Konfiguration oder Eigenschaft vorhanden ist.
Wenn der Condition-Parameter der Warning-Aufgabe true ergibt, wird der Wert des Text-Parameters protokolliert und der Buildvorgang fortgesetzt. Wenn kein Condition-Parameter vorhanden ist, wird der Warnungstext protokolliert. Weitere Informationen zur Protokollierung finden Sie unter Übersicht über die Protokollierung in MSBuild.
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 wird nach Eigenschaften gesucht, die über die Befehlszeile festgelegt wurden. Wenn keine Eigenschaften festgelegt wurden, löst das Projekt ein Warnereignis aus und protokolliert den Wert des Text-Parameters der Warning-Aufgabe.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<Target Name="ValidateCommandLine">
<Warning
Text=" The 0 property was not set on the command line."
Condition="'$(0)' == ''" />
<Warning
Text=" The FREEBUILD property was not set on the command line."
Condition="'$(FREEBUILD)' == ''" />
</Target>
...
</Project>