Freigeben über

Error-Aufgabe

Aktualisiert: November 2007

Hält einen Build an und protokolliert einen Fehler anhand einer ausgewerteten Bedingungsanweisung.

Parameter

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

Parameter

Beschreibung

Code

Optionaler String-Parameter.

Der dem Fehler zuzuordnende Fehlercode.

HelpKeyword

Optionaler String-Parameter.

Das dem Fehler zuzuordnende Schlüsselwort der Hilfe.

Text

Optionaler String-Parameter.

Der Fehlertext, den MSBuild protokolliert, wenn der Condition-Parameter true ergibt.

Hinweise

Mithilfe der Error-Aufgabe können MSBuild-Projekte Fehlertext an Protokollierungen ausgeben und die Buildausführung anhalten.

Wenn der Condition-Parameter true ergibt, wird die Buildausführung angehalten und ein Fehler protokolliert. Wenn kein Condition-Parameter vorhanden ist, wird der Fehler protokolliert und die Buildausführung angehalten. Weitere Informationen zur Protokollierung finden Sie unter Übersicht über die Protokollierung in MSBuild.

Beispiel

Im folgenden Codebeispiel wird überprüft, ob alle erforderlichen Eigenschaften festgelegt sind. Wenn sie nicht festgelegt sind, löst das Projekt ein Fehlerereignis aus und protokolliert den Wert des Text-Parameters der Error-Aufgabe.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="ValidateCommandLine">
        <Error
            Text=" The 0 property must be set on the command line."
            Condition="'$(0)' == ''" />
        <Error
            Text="The FREEBUILD property must be set on the command line."
            Condition="'$(FREEBUILD)' == ''" />
    </Target>
    ...
</Project>

Siehe auch

Konzepte

Übersicht über die Protokollierung in MSBuild

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben

  • Last updated on