-target (Visual Basic)

  • Článek

Určuje formát výstupu kompilátoru.

Syntaxe

-target:{exe | library | module | winexe | appcontainerexe | winmdobj}

Poznámky

Následující tabulka shrnuje účinek -target možnosti.

Možnost Chování
-target:exe Způsobí, že kompilátor vytvoří spustitelné konzolové aplikace.

Toto je výchozí možnost, pokud není zadána žádná -target možnost. Spustitelný soubor se vytvoří s příponou .exe.

Pokud není u -out této možnosti uvedeno jinak, název výstupního souboru převezme název vstupního souboru, který obsahuje proceduru Sub Main .

V souborech zdrojového kódu, které jsou zkompilovány do souboru .exe, je vyžadován pouze jeden Sub Main postup. Pomocí možnosti kompilátoru -main určete, která třída obsahuje proceduru Sub Main .
-target:library Způsobí, že kompilátor vytvoří dynamickou knihovnu (DLL).

Soubor dynamické knihovny se vytvoří s příponou .dll.

Pokud není u -out této možnosti uvedeno jinak, název výstupního souboru převezme název prvního vstupního souboru.

Při vytváření knihovny DLL není nutné provést proceduru Sub Main .
-target:module Způsobí, že kompilátor vygeneruje modul, který lze přidat do sestavení.

Výstupní soubor se vytvoří s příponou .netmodule.

Modul clr .NET common language runtime nemůže načíst soubor, který nemá sestavení. Tento soubor však můžete začlenit do manifestu sestavení sestavení pomocí -reference.

Pokud kód v jednom modulu odkazuje na interní typy v jiném modulu, musí být oba moduly začleněny do manifestu sestavení pomocí -reference.

Možnost -addmodule importuje metadata z modulu.
-target:winexe Způsobí, že kompilátor vytvoří spustitelné aplikace založené na systému Windows.

Spustitelný soubor se vytvoří s příponou .exe. Aplikace založená na Systému Windows je aplikace, která poskytuje uživatelské rozhraní z knihovny tříd rozhraní .NET Framework nebo pomocí rozhraní API systému Windows.

Pokud není u -out této možnosti uvedeno jinak, název výstupního souboru převezme název vstupního souboru, který obsahuje proceduru Sub Main .

V souborech zdrojového kódu, které jsou zkompilovány do souboru .exe, je vyžadován pouze jeden Sub Main postup. V případech, kdy má váš kód více než jednu třídu, která má proceduruSub Main, použijte možnost kompilátoru -main určit, která třída obsahuje proceduru.Sub Main
-target:appcontainerexe Způsobí, že kompilátor vytvoří spustitelné aplikace založené na Windows, která se musí spustit v kontejneru aplikace. Toto nastavení je navržené tak, aby se používalo pro aplikace windows 8.x Store.

Nastavení appcontainerexe nastaví bit v poli Vlastnosti přenosného spustitelného souboru. Tento bit označuje, že aplikace musí být spuštěná v kontejneru aplikace. Pokud je tento bit nastaven, dojde k chybě, pokud CreateProcess se metoda pokusí spustit aplikaci mimo kontejner aplikace. Kromě tohoto nastavení bitu je -target:appcontainerexe ekvivalentní -target:winexe.

Spustitelný soubor se vytvoří s příponou .exe.

Pokud neurčíte jinak pomocí -out této možnosti, název výstupního souboru převezme název vstupního souboru, který obsahuje proceduru Sub Main .

V souborech zdrojového kódu, které jsou zkompilovány do souboru .exe, je vyžadován pouze jeden Sub Main postup. Pokud váš kód obsahuje více než jednu třídu, která má proceduru Sub Main , pomocí možnosti kompilátoru -main určete, která třída obsahuje proceduru Sub Main .
-target:winmdobj Způsobí, že kompilátor vytvoří zprostředkující soubor, který můžete převést na prostředí Windows Runtime binární soubor (.winmd). Soubor .winmd může využívat javascriptové a C++ programy kromě spravovaných jazykových programů.

Zprostředkující soubor se vytvoří s příponou .winmdobj.

Pokud neurčíte jinak pomocí -out této možnosti, název výstupního souboru převezme název prvního vstupního souboru. Postup Sub Main není povinný.

Soubor .winmdobj je navržený tak, aby byl použit jako vstup pro WinMDExp nástroj pro export k vytvoření souboru metadat Systému Windows (WinMD). Soubor WinMD má příponu .winmd a obsahuje kód z původní knihovny i definice WinMD, které JavaScript, C++ a prostředí Windows Runtime použít.

Pokud nezadáte -target:module, -target způsobí přidání manifestu sestavení rozhraní .NET Framework do výstupního souboru.

Každá instance Vbc.exe vytvoří maximálně jeden výstupní soubor. Pokud zadáte možnost kompilátoru, například -out nebo -target vícekrát, spustí se poslední proces kompilátoru. Do manifestu se přidají informace o všech souborech v kompilaci. Všechny výstupní soubory s výjimkou těch vytvořených s -target:module metadaty sestavení v manifestu. K zobrazení metadat ve výstupním souboru použijte Ildasm.exe (IL Disassembler ).

Krátká forma -target je -t.

Nastavení cíle v integrovaném vývojovém prostředí sady Visual Studio

  1. Vyberte projekt v Průzkumník řešení. V nabídce Projekt klepněte na příkaz Vlastnosti.

  2. Klikněte na kartu Aplikace .

  3. Upravte hodnotu v poli Typ aplikace.

Příklad

Následující kód se zkompiluje in.vba vytváří in.dll:

vbc -target:library in.vb

Viz také