Freigeben über

Warnungsaufgabe

  • Artikel

Protokolliert während eines Builds eine Warnung, die auf einer ausgewerteten Bedingungsanweisung basiert

Parameter

In der folgenden Tabelle werden die Parameter der Warning -Aufgabe beschrieben.

Parameter Beschreibung
Code Optionaler String-Parameter.

Der Warncode, der der Warnung zugeordnet werden soll.
File Optionaler String-Parameter.

Gibt die relevante Datei an, falls vorhanden. Wenn keine Datei angegeben wird, wird die Datei verwendet, die die Warnungsaufgabe enthält.
HelpKeyword Optionaler String-Parameter.

Das der Warnung zuzuordnende Hilfeschlüsselwort. Nur zur internen Verwendung.
HelpLink Optionaler String-Parameter.

Ein Link zu weiteren Informationen zur Warnung
Text Optionaler String-Parameter.

Der Warnungstext, den MSBuild protokolliert, wenn der Condition-Parameter als true ausgewertet wird.

Hinweise

Die Warning-Aufgabe ermöglicht es MSBuild-Projekten, zu prüfen, ob eine erforderliche Konfiguration oder Eigenschaft vorhanden ist, bevor der nächste Schritt des Buildvorgangs ausgeführt wird.

Wenn der Condition-Parameter der Warning-Aufgabe true ergibt, wird der Wert des Text-Parameters protokolliert und der Build weiter ausgeführt. Wenn kein Condition-Parameter vorhanden ist, wird der Warnungstext protokolliert. Weitere Informationen zur Protokollierung finden Sie unter Erhalten von Buildprotokollen.

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.

HelpKeyword wird von Visual Studio verwendet, um das Kontexthilfefeature (F1) zu unterstützen. Sie können HelpLink verwenden, um eine Onlinehilfeseite einer Fehlermeldung zuzuordnen.

Beispiel

Mithilfe des folgenden Codebeispiels können Sie nach Eigenschaften suchen, die in der Befehlszeile festgelegt sind. Wenn keine Eigenschaften festgelegt sind, löst das Projekt ein Warnungsereignis aus und protokolliert den Wert des Text-Parameters der Warning-Aufgabe.

<Project xmlns="http://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>

Siehe auch