Referenční dokumentace úlohy MSBuild

  • Článek

Úlohy poskytují kód, který se spouští během procesu sestavení. Úlohy v následujícím seznamu jsou součástí nástroje MSBuild. Při instalaci úlohy C++ jsou k dispozici další úlohy, které se používají k sestavení projektů C++. Další informace naleznete v tématu úlohy jazyka C++.

Kromě parametrů uvedených v tématech v této části má každý úkol také následující parametry:

Parametr Popis
Condition Volitelný String parametr.

Výraz Boolean , který modul MSBuild používá k určení, zda bude tato úloha spuštěna. Informace o podmínkách podporovaných nástrojem MSBuild naleznete v tématu Podmínky.
ContinueOnError Volitelný parametr. Může obsahovat jednu z následujících hodnot:

- WarnAndContinue nebo true. Pokud úloha selže, následné úkoly v cílovém prvku a sestavení budou pokračovat v provádění a všechny chyby z úkolu se považují za upozornění.
- ErrorAndContinue. Pokud úloha selže, následné úkoly v elementu Target a sestavení budou pokračovat v provádění a všechny chyby z úkolu se považují za chyby.
- ErrorAndStop nebo false (výchozí). Pokud úloha selže, zbývající úkoly v elementu Target a sestavení se nespustí a celý Target prvek a sestavení se považuje za neúspěšné.

Verze rozhraní .NET Framework před verzí 4.5 podporovaly true pouze hodnoty a false hodnoty.

Další informace naleznete v tématu Postupy: Ignorování chyb v úkolech.

V této části

Přidá několik parametrů k úkolům, které jsou odvozeny z Task třídy. Není určeno k přímému použití.

Přidá několik parametrů k úkolům, které jsou odvozeny z TaskExtension třídy. Není určeno k přímému použití.

Přidá několik parametrů k úkolům, které jsou odvozeny z ToolTaskExtension třídy. Není určeno k přímému použití.

Vytvoří sestavení s manifestem z jednoho nebo více souborů, které jsou moduly nebo soubory prostředků.

Zabalí aspnet_compiler.exe, nástroj pro předkompilování ASP.NET aplikace.

Přiřadí identifikátory jazykové verze k položkám.

Přijme seznam konfiguračních řetězců a přiřadí je zadaným projektům.

Přijme seznam souborů a přidá <TargetPath> atributy, pokud ještě nejsou zadané.

Vyvolá cíl v souboru projektu.

Kombinuje zadané cesty do jedné cesty.

Převede relativní cestu nebo odkaz na absolutní cestu.

Zkopíruje soubory do nového umístění.

Vytvoří název manifestu ve stylu C#z daného názvu souboru .resx nebo jiného prostředku.

Naplní kolekce položek ze vstupních položek, což umožňuje zkopírování položek z jednoho seznamu do druhého.

Naplní vlastnosti ze vstupních hodnot, což umožňuje zkopírování hodnot z jedné vlastnosti nebo řetězce do jiné.

Vytvoří název manifestu ve stylu Visual Basic z daného názvu souboru .resx nebo jiného prostředku.

Vyvolá kompilátor Jazyka Visual C#, který vytvoří spustitelné soubory, knihovny dynamického propojení nebo moduly kódu.

Odstraní zadané soubory.

Stáhne soubor do zadaného umístění.

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

Spustí zadaný program nebo příkaz se zadanými argumenty.

Vyhledá v zadaných seznamech soubor app.config ( pokud existuje).

Najde položku v zadaném seznamu, který má odpovídající položky.

Určuje, které položky v zadané kolekci položek existují v zadané složce a ve všech jejích podsložkách.

Převede adresu URL na správný formát adresy URL.

Připojí číslo revize k číslu verze.

Generuje manifest aplikace ClickOnce nebo nativní manifest.

Poskytuje automatizovaný způsob, jak rozpoznat, stáhnout a nainstalovat aplikaci a její požadavky.

Vygeneruje manifest nasazení ClickOnce.

Převede soubory .txt a .resx na binární soubory .resources modulu CLR (Common Language Runtime).

Vygeneruje vztah důvěryhodnosti aplikace ze základního manifestu TargetZone a z parametrů.ExcludedPermissions

Načte identity sestavení ze zadaných souborů a vypíše informace o identitě.

Vypočítá kontrolní součty obsahu souboru nebo sady souborů.

Načte cestu k sestavením rozhraní .NET Framework.

Načte cestu k sadě Windows Software Development Kit (SDK).

Vrátí referenční cesty sestavení různých architektur.

Vygeneruje soubor .license ze souboru .licx .

Vytvoří adresáře a v případě potřeby všechny nadřazené adresáře.

Zaznamená zprávu během sestavení.

Přesune soubory do nového umístění.

Sestaví projekty MSBuild z jiného projektu MSBuild.

Přečte seznam položek z textového souboru.

Načte metadata v zadaném sestavení a přidá do registru potřebné položky.

Odebere zadané adresáře a všechny jeho soubory a podadresáře.

Odebere duplicitní položky ze zadané kolekce položek.

Určuje, zda aplikace vyžaduje rozhraní .NET Framework 3.5 SP1.

  • ResGen – úloha

Zastaralé. Pomocí úlohy GenerateResource převeďte soubory .txt a .resx do binárních souborů .resources modulu CLR (Common Language Runtime).

Určuje všechna sestavení, která závisí na zadaných sestaveních.

Vezme seznam jednoho nebo více názvů knihoven typů nebo souborů .tlb a přeloží tyto knihovny typů na umístění na disku.

Určuje zdroj klíče silného názvu.

Řeší následující položky v procesu sestavení do souborů pro generování manifestu: sestavené položky, závislosti, satelity, obsah, symboly ladění a dokumentaci.

Řeší nativní odkazy.

Určuje výstupní soubory pro odkazy na projekt jiné než MSBuild.

Vytvoří sestavení serializace XML pro typy v zadaném sestavení.

Podepíše zadaný soubor pomocí zadaného certifikátu.

Nastaví dobu přístupu a úprav souborů.

Zruší registraci zadaných sestavení pro účely spolupráce modelu COM.

Rozbalí archiv .zip do zadaného umístění.

Aktualizace vybraných vlastností v manifestu a rezignuje.

Vyvolá kompilátor jazyka Visual Basic, který vytvoří spustitelné soubory, knihovny dynamického propojení nebo moduly kódu.

Ověří, že soubor odpovídá očekávané hodnotě hash souboru.

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

Vygeneruje dočasný soubor kódu pomocí zadaného vygenerovaného fragmentu kódu. Neodstraní soubor.

Zapíše zadané položky do zadaného textového souboru.

Vrátí hodnoty zadané dotazem XPath ze souboru XML.

Nastaví hodnoty zadané dotazem XPath do souboru XML.

Transformuje vstup XML pomocí transformace XSLT (Extensible Stylesheet Language Transformation ) nebo zkompilované XSLT a výstupy do výstupního zařízení nebo souboru.

Vytvoří archiv .zip z obsahu adresáře.

Viz také