Warning-Aufgabe
Aktualisiert: November 2007
Protokolliert eine Warnung während eines Buildvorgangs auf der Grundlage einer ausgewerteten Bedingungsanweisung.
Parameters
In der folgenden Tabelle werden die Parameter der Warning-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
Code |
Optionaler String-Parameter. Der der Warnung zuzuordnende Warncode. |
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.
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>