Sdílet prostřednictvím

Chyba úkolu

  • Článek

Zastaví sestavení a zaznamená chybu na základě zhodnocena podmíněného příkazu.

Parametry

Tabulka následujícího popisuje parametry Error úkolu.

Parametr

Description

Code

Volitelný String parametr.

Kód chyby, které chcete přidružit k chybě.

File

Volitelný String parametr.

Název souboru, který obsahuje chybu.Není-li žádný název souboru, bude použit soubor obsahující chybu úkol.

HelpKeyword

Volitelný String parametr.

Chyba přiřadit klíčové slovo nápovědy.

Text

Volitelný String parametr.

Text chyby, MSBuild protokoly, pokud Condition parametrů vyhodnocen na true.

Poznámky

Error Úloh umožňuje MSBuild projekty úhozy kláves vydá text chyby a zastavíte sestavení.

Pokud Condition parametrů vyhodnocen na true, sestavení je zastaven a zaznamenána chyba.Pokud Condition parametr neexistuje, chyba zaznamenána a sestavit spuštění zastaví.Další informace o protokolování naleznete v Získávání protokolů o sestavení pomocí nástroje MSBuild.

Vedle výše uvedených parametrů, zdědí tento úkol parametry z TaskExtension dědí třídu, která sama Task třídy.Seznam těchto další parametry a jejich popis naleznete v TaskExtension základní třída.

Příklad

Následující příklad kódu ověří, že všechny požadované vlastnosti jsou nastaveny.Pokud není nastavena, projekt vyvolává událost chyby a zaznamená hodnotu Text parametr Error úkolu.

<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>

Viz také

Koncepty

Získávání protokolů o sestavení pomocí nástroje MSBuild

Další zdroje

Úloha MSBuild odkaz