Csc – úloha

Zabalí csc.exe a vytvoří spustitelné soubory (soubory .exe), knihovny dynamického propojení (soubory DLL) nebo moduly kódu (soubory .netmodule). Další informace o csc.exe naleznete v tématu možnosti kompilátoru jazyka C#.

Parametry

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

Parametr	Popis
AdditionalLibPaths	Volitelný String[] parametr. Určuje další adresáře, které se mají vyhledat odkazy. Další informace najdete v tématu -lib (možnosti kompilátoru jazyka C#).
AddModules	Volitelný String parametr. Určuje jeden nebo více modulů, které mají být součástí sestavení. Další informace naleznete v tématu -addmodule (možnosti kompilátoru jazyka C#).
AllowUnsafeBlocks	Volitelný Boolean parametr. Pokud true, zkompiluje kód, který používá nebezpečné klíčové slovo. Další informace najdete v tématu -nezabezpečené (možnosti kompilátoru jazyka C#).
ApplicationConfiguration	Volitelný String parametr. Určuje konfigurační soubor aplikace obsahující nastavení vazby sestavení.
BaseAddress	Volitelný String parametr. Určuje upřednostňovanou základní adresu, pro kterou se má načíst knihovna DLL. Výchozí základní adresa knihovny DLL je nastavena modulem CLR .NET Framework. Další informace najdete v tématu -baseaddress (možnosti kompilátoru jazyka C#).
CheckForOverflowUnderflow	Volitelný Boolean parametr. Určuje, jestli celočíselná aritmetika, která přetečí hranice datového typu, způsobí výjimku za běhu. Další informace najdete v tématu -checked (možnosti kompilátoru jazyka C#).
ChecksumAlgorithm	Volitelný String parametr. Určuje algoritmus pro výpočet kontrolního součtu zdrojového souboru uloženého v souboru PDB. Algoritmus musí být BUĎ SHA1 (výchozí) nebo SHA256. Viz ChecksumAlgorithm.
CodeAnalysisRuleset	Volitelný String parametr. Určuje soubor sady pravidel, který zakazuje konkrétní diagnostiku. Viz CodeAnalysisRuleset.
CodePage	Volitelný Int32 parametr. Určuje znakovou stránku, která se má použít pro všechny soubory zdrojového kódu v kompilaci. Další informace naleznete v tématu -codepage (možnosti kompilátoru jazyka C#).
DebugType	Volitelný String parametr. Určuje typ ladění. DebugType může být full nebo pdbonly. Výchozí hodnota je full, která umožňuje, aby ladicí program byl připojen ke spuštěné aplikaci. Zadáním povolíte pdbonly ladění zdrojového kódu při spuštění programu v ladicím programu, ale při připojení spuštěného programu k ladicímu programu se zobrazí pouze assembler. Tento parametr přepíše EmitDebugInformation parametr. Další informace najdete v tématu -debug (možnosti kompilátoru jazyka C#).
DefineConstants	Volitelný String parametr. Definuje symboly preprocesoru. Další informace najdete v tématu -define (možnosti kompilátoru jazyka C#).
DelaySign	Volitelný Boolean parametr. Pokud trueurčuje, že chcete do sestavení umístit pouze veřejný klíč. Pokud false, určuje, že chcete plně podepsané sestavení Tento parametr nemá žádný vliv, pokud se nepoužívá s parametrem nebo parametrem KeyFileKeyContainer . Další informace najdete v tématu -delaysign (možnosti kompilátoru jazyka C#).
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 najdete v tématu -deterministic (možnosti kompilátoru jazyka C#).
DisabledWarnings	Volitelný String parametr. Určuje seznam upozornění, která se mají zakázat. Další informace najdete v tématu -nowarn (možnosti kompilátoru jazyka C#).
DocumentationFile	Volitelný String parametr. Zpracovává komentáře dokumentace k souboru XML. Další informace najdete v tématu -doc (možnosti kompilátoru jazyka C#).
EmbedAllSources	Volitelný Boolean parametr. Vložte všechny zdrojové soubory do souboru PDB. Další informace najdete v tématu -embed (možnosti kompilátoru jazyka C#)
EmitDebugInformation	Volitelný Boolean parametr. Pokud trueúloha vygeneruje informace o ladění a umístí je do souboru databáze programu (.pdb). Pokud falseúloha nevygeneruje žádné informace o ladění. Výchozí hodnota je false. Další informace najdete v tématu -debug (možnosti kompilátoru jazyka C#).
ErrorLog	Volitelný String parametr. Určuje soubor, který bude protokolovat veškerou diagnostiku kompilátoru a analyzátoru. Viz Protokol chyb.
ErrorReport	Volitelný String parametr. Poskytuje pohodlný způsob, jak microsoftu hlásit vnitřní chybu jazyka C#. Tento parametr může mít hodnotu prompt, sendnebo none. Pokud je parametr nastavený na prompt, zobrazí se výzva, když dojde k vnitřní chybě kompilátoru. Tato výzva vám umožní elektronicky odeslat microsoftu zprávu o chybě. Pokud je parametr nastavený na send, automaticky se odešle zpráva o chybě. Pokud je parametr nastaven na none, zobrazí se chyba pouze v textovém výstupu kompilátoru. Výchozí hodnota je none. Další informace najdete v tématu -errorreport (možnosti kompilátoru jazyka C#).
FileAlignment	Volitelný Int32 parametr. Určuje velikost oddílů ve výstupním souboru. Další informace najdete v tématu -filealign (možnosti kompilátoru jazyka C#).
GenerateFullPaths	Volitelný Boolean parametr. Pokud trueurčuje absolutní cestu k souboru ve výstupu kompilátoru. Pokud false, určuje název souboru. Výchozí hodnota je false. Další informace naleznete v tématu -fullpaths (možnosti kompilátoru jazyka C#).
HighEntropyVA	Volitelný Boolean parametr Povolení náhodného rozložení adresního prostoru s vysokou entropií (ASLR). Viz HighEntropyVA.
KeyContainer	Volitelný String parametr. Určuje název kontejneru kryptografických klíčů. Další informace najdete v tématu -keycontainer (možnosti kompilátoru C#).
KeyFile	Volitelný String parametr. Určuje název souboru obsahující kryptografický klíč. Další informace najdete v tématu -keyfile (možnosti kompilátoru jazyka C#).
LangVersion	Volitelný String parametr. Určuje verzi jazyka, který se má použít. Další informace naleznete v tématu -langversion (možnosti kompilátoru jazyka C#).
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. Položky předané do tohoto parametru mohou mít volitelné položky metadat s názvem LogicalName a Access. LogicalNameidentifier odpovídá parametru přepínače a Access odpovídá parametru /linkresourceaccessibility-modifier. Další informace najdete v tématu -linkresource (možnosti kompilátoru jazyka C#).
MainEntryPoint	Volitelný String parametr. Určuje umístění Main metody. Další informace najdete v tématu -main (možnosti kompilátoru jazyka C#).
ModuleAssemblyName	Volitelný String parametr. Určuje název sestavení, které bude tento modul součástí.
NoConfig	Volitelný Boolean parametr. Pokud truekompilátor nekompiluje soubor csc.rsp . Další informace najdete v tématu -noconfig (možnosti kompilátoru jazyka C#).
NoLogo	Volitelný Boolean parametr. Pokud true, potlačuje zobrazení informací o banneru kompilátoru. Další informace najdete v tématu -nologo (možnosti kompilátoru jazyka C#).
NoStandardLib	Volitelný Boolean parametr. Pokud truezabrání importu knihovny mscorlib.dll, která definuje celý obor názvů systému. Tento parametr použijte, pokud chcete definovat nebo vytvořit vlastní systémový obor názvů a objekty. Další informace najdete v tématu -nostdlib (možnosti kompilátoru jazyka C#).
NoWin32Manifest	Volitelný Boolean parametr. Pokud truenezahrnujte výchozí manifest Win32.
Nullable	Volitelný String parametr. Určuje kontext s možnou hodnotou null. Argument musí být jeden z enable, disable, warningsnebo annotations. Viz Nullable.
Optimize	Volitelný Boolean parametr. Pokud true, povolí optimalizace. Pokud false, zakáže optimalizace. Další informace najdete v tématu -optimize (možnosti kompilátoru jazyka C#).
OutputAssembly	Volitelný String výstupní parametr. Určuje název výstupního souboru. Další informace najdete v tématu -out (možnosti kompilátoru jazyka C#).
OutputRefAssembly	Volitelný String parametr. Určuje název výstupního referenčního souboru sestavení. Další informace najdete v tématu -refout (možnosti kompilátoru jazyka C#).
PathMap	Volitelný String parametr. Určuje způsob mapování fyzických cest na názvy zdrojových cest výstupem kompilátoru. Viz PathMap.
PdbFile	Volitelný String parametr. Určuje název souboru informací o ladění. Výchozí název je název výstupního souboru s příponou .pdb .
Platform	Volitelný String parametr. Určuje platformu procesoru určenou výstupním souborem. Tento parametr může mít hodnotu x86, x64nebo anycpu. Výchozí hodnota je anycpu. Další informace najdete v tématu -platform (možnosti kompilátoru jazyka C#).
PreferredUILang	Volitelný String parametr. Určuje jazyk, ve kterém kompilátor jazyka C# zobrazuje výstup, například chybové zprávy. Viz PreferredUILang.
PublicSign	Volitelný Boolean parametr. Veřejně podepište výstupní sestavení. Viz PublicSign.
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. Další informace najdete v tématu -reference (možnosti kompilátoru jazyka C#). Alias odkazu jazyka C# můžete zadat v souboru MSBuild přidáním metadat Aliases do původní položky Reference. Pokud například chcete nastavit alias "LS1" na následujícím příkazovém řádku Csc: CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs použili byste: <Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>
RefOnly	Volitelný Boolean parametr. Vytvoří referenční sestavení místo úplného sestavení jako primární výstup. Viz ProduceOnlyReferenceAssembly.
ReportAnalyzer	Volitelný Boolean parametr. Nahlašte další informace analyzátoru, například dobu provádění. Viz ReportAnalyzer.
Resources	Volitelný ITaskItem[] parametr. Vloží prostředek rozhraní .NET Framework do výstupního souboru. Položky předané do tohoto parametru mohou mít volitelné položky metadat s názvem LogicalName a Access. LogicalNameidentifier odpovídá parametru přepínače a Access odpovídá parametru /resourceaccessibility-modifier. Další informace najdete v tématu -resource (možnosti kompilátoru jazyka C#).
ResponseFiles	Volitelný String parametr. Určuje soubor odpovědi, který obsahuje příkazy pro tuto úlohu. Další informace naleznete v tématu @ (zadání souboru odpovědi).
Sources	Volitelný ITaskItem[] parametr. Určuje jeden nebo více zdrojových souborů jazyka C#.
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. Další informace najdete v tématu -target (možnosti kompilátoru jazyka C#).
TreatWarningsAsErrors	Volitelný Boolean parametr. Pokud truese zachází se všemi upozorněními jako s chybami. Další informace najdete v tématu -warnaserror (možnosti kompilátoru jazyka C#).
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. Další informace najdete v tématu -utf8output (možnosti kompilátoru jazyka C#).
WarningLevel	Volitelný Int32 parametr. Určuje úroveň upozornění pro zobrazení kompilátoru. Další informace najdete v tématu -warn (možnosti kompilátoru jazyka C#).
WarningsAsErrors	Volitelný String parametr. Určuje seznam upozornění, která se mají považovat za chyby. Další informace najdete v tématu -warnaserror (možnosti kompilátoru jazyka C#). 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 najdete v tématu -warnaserror (možnosti kompilátoru jazyka C#). 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ů. Další informace najdete v tématu -win32icon (možnosti kompilátoru jazyka C#).
Win32Manifest	Volitelný String parametr. Určuje manifest Win32, který se má zahrnout.
Win32Resource	Volitelný String parametr. Vloží do výstupního souboru soubor prostředku Win32 (.res). Další informace najdete v tématu -win32res (možnosti kompilátoru jazyka C#).

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 používá Csc úlohu ke kompilaci spustitelného souboru ze zdrojových souborů v kolekci Compile položek.

<CSC
    Sources="@(Compile)"
    OutputAssembly="$(AppName).exe"
    EmitDebugInformation="true" />

Viz také

• Referenční dokumentace k úkolu
• Úlohy