Sdílet prostřednictvím

Warning – úloha

  • Článek

Zaznamená upozornění během sestavení na základě vyhodnoceného podmíněného příkazu.

Parametry

Následující tabulka popisuje parametry Warning úlohy.

Parametr Popis
Code Volitelný String parametr.

Kód upozornění, který se má přidružit k upozornění.
File Volitelný String parametr.

Určuje příslušný soubor, pokud existuje. Pokud není k dispozici žádný soubor, použije se soubor obsahující úlohu Upozornění.
HelpKeyword Volitelný String parametr.

Klíčové slovo nápověda, které chcete přidružit k upozornění. Pouze pro vnitřní potřebu
HelpLink Volitelný String parametr.

Odkaz na další informace o upozornění.
Text Volitelný String parametr.

Text upozornění, který MSBuild protokoluje, pokud Condition se parametr vyhodnotí jako true.

Poznámky

Úloha Warning umožňuje projektům MSBuild zkontrolovat přítomnost požadované konfigurace nebo vlastnosti před pokračováním v dalším kroku sestavení.

Pokud se Condition parametr Warning úlohy vyhodnotí jako true, hodnota parametru Text se zaprotokoluje a sestavení bude pokračovat v provádění. Condition Pokud parametr neexistuje, text upozornění se zaprotokoluje. Další informace o protokolování naleznete v tématu Získání protokolů sestavení.

Kromě výše uvedených parametrů tato úloha dědí parametry z TaskExtension třídy, která sama dědí z Task třídy. Seznam těchto dalších parametrů a jejich popisů naleznete v tématu TaskExtension základní třída.

HelpKeyword používá Visual Studio k podpoře funkce kontextové nápovědy (F1). Můžete použít HelpLink k přidružení online stránky nápovědy k chybové zprávě.

Příklad

Následující příklad kódu kontroluje vlastnosti, které jsou nastaveny na příkazovém řádku. Pokud nejsou nastaveny žádné vlastnosti, projekt vyvolá událost upozornění a zaznamená hodnotu Text parametru Warning úkolu.

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

Viz také