Csc – úloha
Zalomí CSC.exe a spustitelných souborů (soubory EXE), dynamických knihoven (soubory DLL) nebo kódové moduly (.netmodule soubory).Další informace o CSC.exe Možnosti kompilátoru C#.
Parametry
Následující tabulka popisuje parametry Csc úkolu.
Parametr |
Description |
|---|---|
AdditionalLibPaths |
Volitelný String[] parametr. Určuje další adresáře vyhledat odkazy.Další informace naleznete v tématu /lib (Možnosti kompilátoru C#). |
AddModules |
Volitelný String parametr. Určuje jeden nebo více modulů část sestavení.Další informace naleznete v tématu /addmodule (Možnosti kompilátoru C#). |
AllowUnsafeBlocks |
Volitelný Boolean parametr. Pokud true, kompiluje kód, který používá nebezpečných klíčové slovo.Další informace naleznete v tématu /unsafe (Možnosti kompilátoru C#). |
ApplicationConfiguration |
Volitelný String parametr. Určuje konfigurační soubor aplikace obsahuje nastavení sestavení vazby. |
BaseAddress |
Volitelný String parametr. Určuje upřednostňovanou základní adresu, ze které se má načítat knihovna DLL.Nastavuje výchozí základní adresa knihovny DLL .NET Framework společného jazykového modulu runtime.Další informace naleznete v tématu /baseaddress (Možnosti kompilátoru C#). |
CheckForOverflowUnderflow |
Volitelný Boolean parametr. Určuje, zda aritmetické, který přetéká hranice typ dat integer způsobí výjimku za běhu.Další informace naleznete v tématu /checked (Možnosti kompilátoru C#). |
CodePage |
Volitelný Int32 parametr. Určuje znakovou stránku, která má být použita pro všechny soubory zdrojového kódu dané kompilace.Další informace naleznete v tématu /codepage (Možnosti kompilátoru C#). |
DebugType |
Volitelný String parametr. Určuje typ ladění.DebugTypecan be full or pdbonly.Výchozí hodnota je full, která umožňuje připojit ke spuštěnému programu ladicí program.Zadání pdbonly zdroje umožňuje ladění kódu v debuggeru spuštění program, ale assembler se zobrazí pouze pokud je připojen ladicí program spuštěný program. Tento parametr přepíše EmitDebugInformation parametr. Další informace naleznete v tématu /debug (Možnosti kompilátoru C#). |
DefineConstants |
Volitelný String parametr. Definuje symboly preprocesoru.Další informace naleznete v tématu /define (Možnosti kompilátoru C#). |
DelaySign |
Volitelný Boolean parametr. Pokud true, určuje, že plně podepsané sestavení.Pokud false, určuje, že chcete umístit veřejný klíč sestavení. Tento parametr nemá žádný účinek, pokud není použit buď KeyFile nebo KeyContainer parametr. Další informace naleznete v tématu /delaysign (Možnosti kompilátoru C#). |
DisabledWarnings |
Volitelný String parametr. Určuje seznam upozornění zakázána.Další informace naleznete v tématu /nowarn (Možnosti kompilátoru C#). |
DocumentationFile |
Volitelný String parametr. Zpracovává dokumentaci komentáře do souboru XML.Další informace naleznete v tématu /doc (Možnosti kompilátoru C#). |
EmitDebugInformation |
Volitelný Boolean parametr. Pokud true, úloha generuje ladicí informace a umístí ji do souboru databáze (PDB) program.Pokud false, úkol vyzařuje žádné informace o ladění.Výchozí hodnota je false.Další informace naleznete v tématu /debug (Možnosti kompilátoru C#). |
ErrorReport |
Volitelný String parametr. Poskytuje pohodlný způsob, jak ohlásit společnosti Microsoft C# vnitřní chybu.Tento parametr může mít hodnotu prompt, send, nebo none.Pokud je parametr nastaven prompt, zobrazí se výzva při výskytu chyby kompilátoru.Do řádku umožňuje elektronicky odeslat hlášení o chybě společnosti Microsoft.Pokud je parametr nastaven send, je automaticky odeslána zpráva Chyba.Pokud je parametr nastaven none, je chyba nahlášena pouze v textový výstup kompilátoru.Výchozí hodnota je none.Další informace naleznete v tématu /errorreport (Možnosti kompilátoru C#). |
FileAlignment |
Volitelný Int32 parametr. Určuje velikost oddílů ve výstupním souboru.Další informace naleznete v tématu /filealign (Možnosti kompilátoru C#). |
GenerateFullPaths |
Volitelný Boolean parametr. Pokud true, výstup kompilátoru určuje absolutní cestu k souboru.Pokud false, určuje název souboru.Výchozí hodnota je false.Další informace naleznete v tématu /fullpaths (Možnosti kompilátoru C#). |
KeyContainer |
Volitelný String parametr. Určuje název kontejneru kryptografického klíče.Další informace naleznete v tématu /keycontainer (Možnosti kompilátoru C#). |
KeyFile |
Volitelný String parametr. Určuje název souboru obsahující kryptografický klíč.Další informace naleznete v tématu /keyfile (Možnosti kompilátoru C#). |
LangVersion |
Volitelný String parametr. Určuje verzi a jazyk.Další informace naleznete v tématu /langversion (Možnosti kompilátoru C#). |
LinkResources |
Volitelný ITaskItem[] parametr. Vytvoří odkaz .NET Framework prostředku ve výstupním souboru; soubor prostředků není umístění výstupního souboru. Položky předán tento parametr může mít volitelné metadata položky s názvem LogicalName a Access.LogicalNameodpovídá identifier parametr /linkresource přepnout, a Access odpovídá accessibility-modifier parametr.Další informace naleznete v tématu /linkresource (Možnosti kompilátoru C#). |
MainEntryPoint |
Volitelný String parametr. Určuje umístění Main metoda.Další informace naleznete v tématu /main (Možnosti kompilátoru C#). |
ModuleAssemblyName |
Volitelný String parametr. Určuje název sestavení, která tento modul bude součástí. |
NoConfig |
Volitelný Boolean parametr. Pokud true, říká kompilátoru nelze kompilovat soubor csc.rsp.Další informace naleznete v tématu /noconfig (Možnosti kompilátoru C#). |
NoLogo |
Volitelný Boolean parametr. Pokud true, potlačí zobrazení nápisu informace kompilátoru.Další informace naleznete v tématu /nologo (Možnosti kompilátoru C#). |
NoStandardLib |
Volitelný Boolean parametr. Pokud true, brání importu mscorlib.dll, které definuje obor názvů celého systému.Tento parametr použijte, pokud chcete definovat nebo vytvořit vlastní objekty a oboru názvů System.Další informace naleznete v tématu /nostdlib (Možnosti kompilátoru C#). |
NoWin32Manifest |
Volitelný Boolean parametr. Pokud true, nezahrnujte manifest výchozí Win32. |
Optimize |
Volitelný Boolean parametr. Pokud true, umožňuje optimalizaci.Pokud false, zakáže optimalizace.Další informace naleznete v tématu /optimize (Možnosti kompilátoru C#). |
OutputAssembly |
Volitelný String výstupní parametr. Určuje název výstupního souboru.Další informace naleznete v tématu /out (Možnosti kompilátoru C#). |
PdbFile |
Volitelný String parametr. Určuje název souboru ladicích informací.Výchozí název je název výstupního souboru s příponou PDB. |
Platform |
Volitelný String parametr. Určuje platformu procesoru zaměřeny výstupní soubor.Tento parametr může mít hodnotu x86, x64, nebo anycpu.Výchozí hodnota je anycpu.Další informace naleznete v tématu /platform (Možnosti kompilátoru C#). |
References |
Volitelný ITaskItem[] parametr. Způsobí, že úloha import typu veřejné informace z určených položek do aktuálního projektu.Další informace naleznete v tématu /reference (Možnosti kompilátoru C#). Můžete zadat Visual C# alias v odkazu MSBuild přidáním metadata souboru Aliases původní položky "Odkaz".Chcete-li například nastavit na příkazovém řádku CSC alias "LS1": použijete: |
Resources |
Volitelný ITaskItem[] parametr. Vloží .NET Framework prostředku do výstupního souboru. Položky předán tento parametr může mít volitelné metadata položky s názvem LogicalName a Access.LogicalNameodpovídá identifier parametr /resource přepnout, a Access odpovídá accessibility-modifier parametr.Další informace naleznete v tématu /resource (Možnosti kompilátoru C#). |
ResponseFiles |
Volitelný String parametr. Určuje soubor odpovědí obsahuje příkazy pro tento úkol.Další informace naleznete v tématu @ (Možnosti kompilátoru C#). |
Sources |
Volitelný ITaskItem[] parametr. Určuje jednu nebo více Visual C# zdrojové soubory. |
TargetType |
Volitelný String parametr. Určuje formát výstupního souboru.Tento parametr může mít hodnotu library, který vytvoří kód knihovny exe, který vytvoří aplikace konzoly module, které vytvoří modul, nebo winexe, který vytvoří Windows program.Výchozí hodnota je library.Další informace naleznete v tématu /target (Možnosti kompilátoru C#). |
TreatWarningsAsErrors |
Volitelný Boolean parametr. Pokud true, zpracovává všechna upozornění jako chyby.Další informace naleznete v tématu /warnaserror (Možnosti kompilátoru C#). |
UseHostCompilerIfAvailable |
Volitelný Boolean parametr. Pokyn úloh použít objekt vnitroprocesový kompilátor, pokud je k dispozici.Použít pouze Visual Studio. |
Utf8Output |
Volitelný Boolean parametr. Protokoly kompilátoru, výstup pomocí kódování UTF-8.Další informace naleznete v tématu /utf8output (Možnosti kompilátoru C#). |
WarningLevel |
Volitelný Int32 parametr. Určuje úroveň upozornění kompilátoru, která chcete zobrazit.Další informace naleznete v tématu /warn (Možnosti kompilátoru C#). |
WarningsAsErrors |
Volitelný String parametr. Určuje seznam upozornění jako chyby.Další informace naleznete v tématu /warnaserror (Možnosti kompilátoru C#). Tento parametr přepíše TreatWarningsAsErrors parametr. |
WarningsNotAsErrors |
Volitelný String parametr. Určuje seznam upozornění, které nejsou považovány za chyby.Další informace naleznete v tématu /warnaserror (Možnosti kompilátoru C#). Tento parametr je užitečné, pokud TreatWarningsAsErrors parametr nastaven na true. |
Win32Icon |
Volitelný String parametr. Vloží soubor ICO sestavení, která dává výstupní soubor v Průzkumníku souborů požadovaný vzhled.Další informace naleznete v tématu /win32icon (Možnosti kompilátoru C#). |
Win32Manifest |
Volitelný String parametr. Určuje manifestu do systému Win32. |
Win32Resource |
Volitelný String parametr. Vloží soubor Win32 (RES) prostředků ve výstupním souboru.Další informace naleznete v tématu /win32res (Možnosti kompilátoru C#). |
Poznámky
Kromě výše uvedených parametrů, zdědí tento úkol parametry z Microsoft.Build.Tasks.ManagedCompiler třídy, která dědí z ToolTaskExtension dědí třídu, která sama ToolTask třídy.Seznam těchto další parametry a jejich popis naleznete v ToolTaskExtension – základní třída.
Příklad
V následujícím příkladu Csc úkol shromažďovat spustitelný soubor ze zdrojových souborů v Compile položka kolekce.
<CSC
Sources="@(Compile)"
OutputAssembly="$(AppName).exe"
EmitDebugInformation="true" />