Csc – úloha

  • Článek

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 KeyFile KeyContainer .

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 /linkresource accessibility-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 /resource accessibility-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é