Csc – úloha

Zabalí csc.exea vytvoří spustitelné soubory ( soubory.exe ), knihovny dynamického propojení ( soubory.dll ) nebo moduly kódu (soubory.netmodule ). Další informace o csc.exenajdete 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í hledat 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 najdete v tématu -addmodule (možnosti kompilátoru jazyka C#).
AllowUnsafeBlocks Volitelný Boolean parametr.

Pokud true, kompiluje kód, který používá nebezpečné klíčové slovo. Další informace najdete v tématu -nebezpečný (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, do které 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, zda 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#).
CodePage Volitelný Int32 parametr.

Určuje kódovou stránku, která se má použít pro všechny soubory zdrojového kódu v kompilaci. Další informace najdete 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 připojení ladicího programu ke spuštěné aplikaci. Určení pdbonly umožňuje 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ím 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 KeyContainer parametremKeyFile.

Další informace najdete v tématu -delaysign (možnosti kompilátoru jazyka C#).
Deterministic Volitelný Boolean parametr.

Pokud truekompilátor způsobí 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 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í je false. Další informace najdete v tématu -debug (možnosti kompilátoru jazyka C#).
ErrorReport Volitelný String parametr.

Poskytuje pohodlný způsob, jak hlásit interní chybu jazyka C# microsoftu. 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. Výzva vám umožní odeslat zprávu o chybách elektronicky microsoftu. 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í 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 falseurčuje název souboru. Výchozí je false. Další informace najdete v tématu -fullpaths (možnosti kompilátoru jazyka C#).
KeyContainer Volitelný String parametr.

Určuje název kontejneru kryptografických klíčů. Další informace najdete v tématu -keycontainer (možnosti kompilátoru jazyka 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 najdete 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 pojmenované LogicalName a Access. LogicalName odpovídá parametru identifier/linkresource přepínače a Access odpovídá accessibility-modifier parametru. 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 se souborem csc.rsp . Další informace najdete v tématu -noconfig (možnosti kompilátoru jazyka C#).
NoLogo Volitelný Boolean parametr.

Pokud truepotlačí 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 mscorlib.dll, který definuje celý obor názvů systému. Tento parametr použijte, pokud chcete definovat nebo vytvořit vlastní obor názvů a objekty systému. Další informace najdete v tématu -nostdlib (možnosti kompilátoru jazyka C#).
NoWin32Manifest Volitelný Boolean parametr.

Pokud truenezahrnujte výchozí manifest Win32.
Optimize Volitelný Boolean parametr.

Pokud truepovolíte optimalizace. Pokud falsezakážete 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#).
PdbFile Volitelný String parametr.

Určuje název souboru s informacemi 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, nebo x64anycpu. Výchozí je anycpu. Další informace najdete v tématu -platform (možnosti kompilátoru jazyka C#).
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 chcete například 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>
Resources Volitelný ITaskItem[] parametr.

Vloží prostředek rozhraní .NET Framework do výstupního souboru.

Položky předané do tohoto parametru můžou mít volitelné položky metadat s názvem LogicalName a Access. LogicalNameidentifier odpovídá parametru přepínače a Access odpovídá accessibility-modifier parametru/resource. 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 tento úkol. 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 všechna upozornění považují za chyby. Další informace najdete v tématu -warnaserror (možnosti kompilátoru jazyka C#).
UseHostCompilerIfAvailable Volitelný Boolean parametr.

Dává ú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 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ě, že TreatWarningsAsErrors 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íkovi souborů. Další informace najdete v tématu -win32icon (možnosti kompilátoru 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#).

ToolTaskExtension – parametry

Tento úkol dědí z ToolTaskExtension třídy, která dědí z ToolTask třídy, která sama dědí z Task třídy. Tento řetěz dědičnosti přidá do úloh odvozených z nich několik parametrů.

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

Parametr Popis
EchoOff Volitelný bool parametr.

Pokud je truenastavená hodnota , tento úkol předá příkazový řádek /Q docmd.exe příkazového řádku 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 zadat název proměnné prostředí a hodnotu oddělenou symbolem rovná se. Tyto proměnné se kromě normálního bloku prostředí předávají do vytvářeného spustitelného souboru nebo selektivně přepíše. Například, Variable1=Value1;Variable2=Value2.
ExitCode Volitelný Int32 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 -1.
LogStandardErrorAsError Volitelný bool parametr.

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

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

Důležitost, se kterou se má protokolovat text ze standardního streamu
Timeout Volitelný Int32 parametr.

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

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

Určuje umístění, ze kterého úloha načte podkladový spustitelný soubor. Pokud tento parametr není zadán, úloha používá 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, vytvoří pro příkazový řádek dávkový soubor a spustí ho pomocí příkazového procesoru místo přímého spuštění příkazu.
YieldDuringToolExecution Volitelný bool parametr.

Při nastavení na truehodnotu tento úkol získá uzel při provádění jeho úkolu.

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é