Freigeben über


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 Hilfeschlüsselwort.

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 Erhalten von Buildprotokollen mit 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>

Siehe auch

Konzepte

Erhalten von Buildprotokollen mit MSBuild

Referenz zum MSBuild-Projektdateischema