Vbc – úloha

  • Článek

Zabalí soubor vbc.exe, který vytváří spustitelné soubory (.exe), knihovny dynamického propojení (.dll) nebo moduly kódu (.netmodule). Další informace o vbc.exe naleznete v jazyce Visual Basic kompilátor příkazového řádku.

Parametry

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

Parametr Popis
AdditionalLibPaths Volitelný String[] parametr.

Určuje další složky, ve kterých se mají hledat sestavení zadaná v atributu Reference.
AddModules Volitelný String[] parametr.

Způsobí, že kompilátor zpřístupní všechny informace o typu ze zadaných souborů pro projekt, který právě kompilujete. Tento parametr odpovídá přepínač -addmodule kompilátoru vbc.exe .
BaseAddress Volitelný String parametr.

Určuje základní adresu knihovny DLL. Tento parametr odpovídá přepínači -baseaddress kompilátoru vbc.exe .
CodePage Volitelný Int32 parametr.

Určuje znakovou stránku, která se má použít pro všechny soubory zdrojového kódu v kompilaci. Tento parametr odpovídá přepínači -codepage kompilátoru vbc.exe .
DebugType Volitelný String[] parametr.

Způsobí, že kompilátor vygeneruje informace o ladění. Tento parametr může mít následující hodnoty:

- full
- pdbonly

Výchozí hodnota je full, která umožňuje připojení ladicího programu ke spuštěné aplikaci. Hodnota umožňuje ladění zdrojového pdbonly kódu při spuštění programu v ladicím programu, ale zobrazí kód jazyka sestavení pouze v případě, že spuštěný program je připojen k ladicímu programu. Další informace naleznete v tématu -debug (Visual Basic).
DefineConstants Volitelný String[] parametr.

Definuje konstanty podmíněného kompilátoru. Dvojice symbolů a hodnot jsou oddělené středníky a jsou určeny následující syntaxí:

symbol1=hodnota1;symbol2 hodnota2=

Tento parametr odpovídá přepínači -define kompilátoru vbc.exe .
DelaySign Volitelný Boolean parametr.

Pokud trueúkol umístí veřejný klíč do sestavení. Pokud falseúloha plně podepíše sestavení. Výchozí hodnota je false. Tento parametr nemá žádný vliv, pokud se nepoužívá s parametrem KeyFile nebo parametrem KeyContainer . Tento parametr odpovídá přepínači -delaysign kompilátoru vbc.exe .
Deterministic Volitelný Boolean parametr.

Pokud truezpůsobí, že kompilátor vytvoří výstup sestavení, jehož binární obsah je identický napříč kompilacemi, pokud jsou vstupy identické.

Další informace naleznete v tématu -deterministic.
DisabledWarnings Volitelný String parametr.

Potlačí zadaná upozornění. Stačí zadat číselnou část identifikátoru upozornění. Více upozornění jsou oddělena středníky. Tento parametr odpovídá přepínač -nowarn kompilátoru vbc.exe .
DocumentationFile Volitelný String parametr.

Zpracovává komentáře dokumentace k zadanému souboru XML. Tento parametr přepíše GenerateDocumentation atribut. Další informace najdete v tématu -doc.
EmitDebugInformation Volitelný Boolean parametr.

Pokud trueúloha vygeneruje informace o ladění a umístí je do souboru .pdb . Další informace naleznete v tématu -debug (Visual Basic).
ErrorReport Volitelný String parametr.

Určuje, jak má úloha hlásit vnitřní chyby kompilátoru. Tento parametr může mít následující hodnoty:

- prompt
- send
- none

Pokud prompt je zadán a dojde k vnitřní chybě kompilátoru, zobrazí se uživateli výzva s možností, zda se mají data o chybách odeslat do Microsoftu.

Pokud send je zadán a dojde k vnitřní chybě kompilátoru, úloha odešle data o chybách společnosti Microsoft.

Výchozí hodnota je none, která hlásí chyby pouze v textovém výstupu.

Tento parametr odpovídá přepínači -errorreport kompilátoru vbc.exe .
FileAlignment Volitelný Int32 parametr.

Určuje, v bajtech, kde se mají zarovnat oddíly výstupního souboru. Tento parametr může mít následující hodnoty:

- 512
- 1024
- 2048
- 4096
- 8192

Tento parametr odpovídá přepínač -filealign kompilátoru vbc.exe .
GenerateDocumentation Volitelný Boolean parametr.

Pokud truevygeneruje informace o dokumentaci a umístí je do souboru XML s názvem spustitelného souboru nebo knihovny, kterou úloha vytváří. Další informace najdete v tématu -doc.
Imports Volitelný ITaskItem[] parametr.

Importuje obory názvů ze zadaných kolekcí položek. Tento parametr odpovídá přepínači -imports kompilátoru vbc.exe .
KeyContainer Volitelný String parametr.

Určuje název kontejneru kryptografických klíčů. Tento parametr odpovídá přepínač -keycontainer kompilátoru vbc.exe .
KeyFile Volitelný String parametr.

Určuje název souboru obsahující kryptografický klíč. Další informace naleznete v tématu -keyfile.
LangVersion Volitelný System.String parametr.

Určuje jazyková verze, například 15.5.
LinkResources Volitelný ITaskItem[] parametr.

Vytvoří odkaz na prostředek rozhraní .NET Framework ve výstupním souboru; soubor prostředku není umístěn ve výstupním souboru. Tento parametr odpovídá přepínači -linkresource kompilátoru vbc.exe .
MainEntryPoint Volitelný String parametr.

Určuje třídu nebo modul, který obsahuje proceduru Sub Main . Tento parametr odpovídá hlavnímu přepínači kompilátoru vbc.exe.
ModuleAssemblyName Volitelný String parametr.

Určuje sestavení, ve které je tento modul součástí.
NoConfig Volitelný Boolean parametr.

Určuje, že kompilátor by neměl používat soubor vbc.rsp . Tento parametr odpovídá parametru -noconfig kompilátoru vbc.exe .
NoLogo Volitelný Boolean parametr.

Pokud true, potlačuje zobrazení informací o banneru kompilátoru. Tento parametr odpovídá přepínači -nologo kompilátoru vbc.exe .
NoStandardLib Volitelný Boolean parametr.

Způsobí, že kompilátor nebude odkazovat na standardní knihovny. Tento parametr odpovídá přepínači -nostdlib kompilátoru vbc.exe .
NoVBRuntimeReference Volitelný Boolean parametr.

Pouze interní použití. Pokud je true, zabrání automatickému odkazu na Microsoft.VisualBasic.dll.
NoWarnings Volitelný Boolean parametr.

Pokud trueúkol potlačí všechna upozornění. Další informace najdete v tématu -nowarn.
Optimize Volitelný Boolean parametr.

Pokud true, povolí optimalizace kompilátoru. Tento parametr odpovídá přepínači -optimize kompilátoru vbc.exe .
OptionCompare Volitelný String parametr.

Určuje způsob porovnávání řetězců. Tento parametr může mít následující hodnoty:

- binary
- text

Hodnota binary určuje, že úloha používá porovnání binárních řetězců. Hodnota text určuje, že úloha používá porovnání textových řetězců. Výchozí hodnota tohoto parametru je binary. Tento parametr odpovídá přepínač -optioncompare kompilátoru vbc.exe .
OptionExplicit Volitelný Boolean parametr.

Je-li truevyžadována explicitní deklarace proměnných. Tento parametr odpovídá přepínači -optionexplicit kompilátoru vbc.exe .
OptionInfer Volitelný Boolean parametr.

Pokud trueumožňuje odvozování typů proměnných.
OptionStrict Volitelný Boolean parametr.

Pokud trueúloha vynucuje striktní sémantiku typu k omezení implicitních převodů typů. Tento parametr odpovídá přepínač -optionstrict kompilátoru vbc.exe .
OptionStrictType Volitelný String parametr.

Určuje, která sémantika striktního typu generuje upozornění. V současné době se podporuje jenom vlastní. Tento parametr odpovídá přepínač -optionstrict kompilátoru vbc.exe .
OutputAssembly Volitelný String výstupní parametr.

Určuje název výstupního souboru. Tento parametr odpovídá přepínač -out kompilátoru vbc.exe .
Platform Volitelný String parametr.

Určuje platformu procesoru určenou výstupním souborem. Tento parametr může mít hodnotu x86, , x64Itaniumnebo anycpu. Výchozí hodnota je anycpu. Tento parametr odpovídá přepínači -platform kompilátoru vbc.exe .
References Volitelný ITaskItem[] parametr.

Způsobí, že úkol importuje informace o veřejném typu ze zadaných položek do aktuálního projektu. Tento parametr odpovídá přepínači -reference kompilátoru vbc.exe .
RemoveIntegerChecks Volitelný Boolean parametr.

Pokud true, zakáže celočíselné přetečení kontroly chyb. Výchozí hodnota je false. Tento parametr odpovídá přepínači -removeintchecks kompilátoru vbc.exe .
Resources Volitelný ITaskItem[] parametr.

Vloží prostředek rozhraní .NET Framework do výstupního souboru. Tento parametr odpovídá přepínači -resource kompilátoru vbc.exe .
ResponseFiles Volitelný ITaskItem[] parametr.

Určuje soubor odpovědi, který obsahuje příkazy pro tuto úlohu. Tento parametr odpovídá možnosti @ (Zadat soubor odpovědi) kompilátoru vbc.exe .
RootNamespace Volitelný String parametr.

Určuje kořenový obor názvů pro všechny deklarace typu. Tento parametr odpovídá přepínač -rootnamespace kompilátoru vbc.exe .
SdkPath Volitelný String parametr.

Určuje umístění knihovny mscorlib.dll a microsoft.visualbasic.dll. Tento parametr odpovídá přepínači -sdkpath kompilátoru vbc.exe .
Sources Volitelný ITaskItem[] parametr.

Určuje jeden nebo více zdrojových souborů jazyka Visual Basic.
TargetCompactFramework Volitelný Boolean parametr.

Pokud trueúkol cílí na rozhraní .NET Compact Framework. Tento přepínač odpovídá přepínači -netcf kompilátoru vbc.exe .
TargetType Volitelný String parametr.

Určuje formát souboru výstupního souboru. Tento parametr může mít hodnotu library, která vytvoří knihovnu kódu, exekterá vytvoří konzolovou aplikaci, modulekterá vytvoří modul, nebo winexe, který vytvoří program systému Windows. Výchozí hodnota je library. Tento parametr odpovídá cílovému přepínači kompilátoru vbc.exe.
Timeout Volitelný Int32 parametr.

Určuje dobu v milisekundách, po které se spustitelný soubor úlohy ukončí. Výchozí hodnota znamená Int.MaxValue, že neexistuje žádné časové období.
ToolPath Volitelný String parametr.

Určuje umístění, odkud úloha načte základní spustitelný soubor (vbc.exe). Pokud tento parametr není zadaný, úloha použije instalační cestu sady SDK odpovídající verzi architektury, na které běží nástroj MSBuild.
TreatWarningsAsErrors Volitelný Boolean parametr.

Pokud truese všechna upozornění považují za chyby. Další informace naleznete v tématu -warnaserror (Visual Basic).
UseHostCompilerIfAvailable Volitelný Boolean parametr.

Dá úkolu pokyn, aby v případě dostupnosti používal objekt kompilátoru v procesu. Používá se jenom v sadě Visual Studio.
Utf8Output Volitelný Boolean parametr.

Protokoluje výstup kompilátoru pomocí kódování UTF-8. Tento parametr odpovídá přepínači -utf8output kompilátoru vbc.exe .
Verbosity Volitelný String parametr.

Určuje úroveň podrobností výstupu kompilátoru. Úroveň podrobností může být Quiet, Normal (výchozí) nebo Verbose.
WarningsAsErrors Volitelný String parametr.

Určuje seznam upozornění, která se mají považovat za chyby. Další informace naleznete v tématu -warnaserror (Visual Basic).

Tento parametr přepíše TreatWarningsAsErrors parametr.
WarningsNotAsErrors Volitelný String parametr.

Určuje seznam upozornění, která nejsou považována za chyby. Další informace naleznete v tématu -warnaserror (Visual Basic).

Tento parametr je užitečný pouze v případě, TreatWarningsAsErrors že je parametr nastaven na true.
Win32Icon Volitelný String parametr.

Vloží soubor .ico do sestavení, který dává výstupnímu souboru požadovaný vzhled v Průzkumník souborů. Tento parametr odpovídá přepínači -win32icon kompilátoru vbc.exe .
Win32Resources Volitelný String parametr.

Vloží do výstupního souboru soubor prostředku Win32 (.res). Tento parametr odpovídá přepínači -win32resource kompilátoru vbc.exe .

Parametry ToolTaskExtension

Tento úkol dědí z ToolTaskExtension třídy, která dědí ze ToolTask třídy, která sama dědí z Task třídy. Tento řetěz dědičnosti přidá několik parametrů k úkolům, které jsou z nich odvozeny.

Následující tabulka popisuje parametry základních tříd:

Parametr Popis
EchoOff Volitelný bool parametr.

Pokud je truetato hodnota nastavena , tento úkol předá příkazovýřádek cmd.exe příkazový řádek tak, aby se příkazový řádek nezkopíroval do stdout.
EnvironmentVariables Volitelný String parametr pole.

Pole definic proměnných prostředí oddělené středníky Každá definice by měla určovat název proměnné prostředí a hodnotu oddělenou symbolem rovná se. Tyto proměnné se předávají do vytvářeného spustitelného souboru kromě pravidelného bloku prostředí nebo selektivně přepisují. Například, Variable1=Value1;Variable2=Value2.
ExitCode Volitelný Int32 výstupní parametr jen pro čtení.

Určuje ukončovací kód, který poskytuje spuštěný příkaz. Pokud úloha protokolovala nějaké chyby, ale proces měl ukončovací kód 0 (úspěch), je nastaven na hodnotu -1.
LogStandardErrorAsError Volitelný bool parametr.

Pokud truese všechny zprávy přijaté ve standardním chybovém streamu zaprotokolují jako chyby.
StandardErrorImportance Volitelný String parametr.

Důležitost, se kterou se má protokolovat text ze standardního datového proudu chyb
StandardOutputImportance Volitelný String parametr.

Důležitost, se kterou se má protokolovat text ze standardního výstupního datového proudu
Timeout Volitelný Int32 parametr.

Určuje dobu v milisekundách, po které se spustitelný soubor úlohy ukončí. Výchozí hodnota znamená Int.MaxValue, že neexistuje žádné časové období. Časový limit je v milisekundách.
ToolExe Volitelný string parametr.

Projekty můžou tuto implementaci implementovat, aby přepsaly ToolName. Úkoly můžou tuto možnost přepsat, aby se zachoval název ToolName.
ToolPath Volitelný string parametr.

Určuje umístění, ze kterého úloha načte základní spustitelný soubor. Pokud tento parametr není zadaný, úloha použije instalační cestu sady SDK, která odpovídá verzi architektury, na které běží nástroj MSBuild.
UseCommandProcessor Volitelný bool parametr.

Pokud je tato úloha nastavená na truehodnotu , vytvoří pro příkazový řádek dávkový soubor a spustí ho pomocí procesoru příkazů místo přímého spuštění příkazu.
YieldDuringToolExecution Volitelný bool parametr.

Pokud je tato hodnota nastavená na true, tento úkol při provádění úkolu získá uzel.

Příklad

Následující příklad zkompiluje projekt jazyka Visual Basic.

<VBC
   Sources="@(sources)"
   Resources="strings.resources"
   Optimize="true"
   OutputAssembly="out.exe"/>

Viz také