Vbc – úloha
Zabalí vbc.exe, což vytváří spustitelné soubory (.exe), knihovny dynamického propojení (.dll) nebo moduly kódu (.netmodule). Další informace o vbc.exe naleznete v tématu Kompilátor příkazového řádku jazyka Visual Basic.
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či -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 true způ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či -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či -filealign kompilátoru vbc.exe . |
GenerateDocumentation |
Volitelný Boolean parametr.Pokud true vygeneruje 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či -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á přepínači -main 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 hodnota 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či -optioncompare kompilátoru vbc.exe . |
OptionExplicit |
Volitelný Boolean parametr.Je-li true vyž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 true umožň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či -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či -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či -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 , , x64 Itanium nebo 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či -rootnamespace kompilátoru vbc.exe . |
SdkPath |
Volitelný String parametr.Určuje umístění 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, exe která vytvoří konzolovou aplikaci, module která 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 vbc.exe kompilátoru. |
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 true se 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ží do sestavení .ico soubor, 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 true tato hodnota nastavená, předá příkazový řádek /Q do příkazového řádku cmd.exe tak, aby se příkazový řádek nezkopíroval do příkazu 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 true se 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 true hodnotu , 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"/>