Csc — Zadanie
CSC.exe jest zawijany i tworzy pliki wykonywalne (pliki .exe), bibliotek dołączanych dynamicznie (pliki .dll) lub modułów kodu (.pliki netmodule).Aby uzyskać więcej informacji na temat CSC.exe, zobacz Opcje kompilatora C#.
Parametry
W poniższej tabeli opisano parametry Csc zadania.
Parametr |
Opis |
|---|---|
AdditionalLibPaths |
Opcjonalny String[] parametru. Określa dodatkowe katalogi wyszukiwania odwołania.Aby uzyskać więcej informacji, zobacz /lib (opcje kompilatora C#). |
AddModules |
Opcjonalny String parametru. Określa jeden lub więcej modułów część zestawu.Aby uzyskać więcej informacji, zobacz /addmodule (opcje kompilatora C#). |
AllowUnsafeBlocks |
Opcjonalny Boolean parametru. Jeśli true, kompiluje kod wykorzystujący niebezpieczne słowa kluczowego.Aby uzyskać więcej informacji, zobacz /unsafe (opcje kompilatora C#). |
ApplicationConfiguration |
Opcjonalny String parametru. Określa plik konfiguracji aplikacji zawierający ustawienia powiązanie zestawu. |
BaseAddress |
Opcjonalny String parametru. Określa preferowany adres bazowy, w którym załadowania biblioteki DLL.Domyślny adres bazowy biblioteki DLL jest ustawiany przez .NET Framework plików wykonywalnych języka wspólnego.Aby uzyskać więcej informacji, zobacz /baseaddress (opcje kompilatora C#). |
CheckForOverflowUnderflow |
Opcjonalny Boolean parametru. Określa, czy arytmetyka, który przelewa granice typu danych powoduje wyjątek w czasie wykonywania.Aby uzyskać więcej informacji, zobacz /checked (opcje kompilatora C#). |
CodePage |
Opcjonalny Int32 parametru. Określa stronę kodową dla wszystkich plików kodu źródłowego w kompilacji.Aby uzyskać więcej informacji, zobacz /codepage (opcje kompilatora C#). |
DebugType |
Opcjonalny String parametru. Określa typ debugowania.DebugTypecan be full or pdbonly.Wartością domyślną jest full, który włącza debuger do uruchomionego programu.Określanie pdbonly umożliwia źródła debugowania kodu, gdy program jest uruchamiany w debugerze, ale assembler wyświetla tylko wtedy, gdy uruchomiony program jest dołączony do debugera. Ten parametr zastępuje EmitDebugInformation parametru. Aby uzyskać więcej informacji, zobacz /debug (opcje kompilatora C#). |
DefineConstants |
Opcjonalny String parametru. Definiuje symboli preprocesora.Aby uzyskać więcej informacji, zobacz /define (opcje kompilatora C#). |
DelaySign |
Opcjonalny Boolean parametru. Jeśli true, określa Zgromadzenie całkowicie podpisane.Jeśli false, określa, że chcesz umieścić w zestawie klucza publicznego. Ten parametr nie ma wpływu chyba, że używany z KeyFile lub KeyContainer parametru. Aby uzyskać więcej informacji, zobacz /delaysign (opcje kompilatora C#). |
DisabledWarnings |
Opcjonalny String parametru. Określa listę ostrzeżeń na wyłączony.Aby uzyskać więcej informacji, zobacz /nowarn (opcje kompilatora C#). |
DocumentationFile |
Opcjonalny String parametru. Przetwarza komentarze dokumentacji do pliku XML.Aby uzyskać więcej informacji, zobacz /doc (opcje kompilatora C#). |
EmitDebugInformation |
Opcjonalny Boolean parametru. Jeśli true, zadanie generuje informacje debugowania i umieszcza je w pliku bazy danych (.pdb) programu.Jeśli false, zadanie emituje informacje o debugowaniu.Wartością domyślną jest false.Aby uzyskać więcej informacji, zobacz /debug (opcje kompilatora C#). |
ErrorReport |
Opcjonalny String parametru. Zapewnia wygodny sposób zgłosić błąd wewnętrzny C# Microsoft.Ten parametr może mieć wartość prompt, send, lub none.Jeśli parametr jest ustawiony na prompt, gdy wystąpi błąd wewnętrzny kompilatora, będzie wyświetlany monit.Monit pozwala wysłać raport o błędzie drogą elektroniczną do firmy Microsoft.Jeśli parametr jest ustawiony na send, zgłoś jest wysyłane automatycznie.Jeśli parametr jest ustawiony na none, tylko w przypadku tekstu dane wyjściowe kompilatora, zgłaszany jest błąd.Wartością domyślną jest none.Aby uzyskać więcej informacji, zobacz /errorreport (opcje kompilatora C#). |
FileAlignment |
Opcjonalny Int32 parametru. Określa rozmiar sekcji w pliku wyjściowym.Aby uzyskać więcej informacji, zobacz /filealign (opcje kompilatora C#). |
GenerateFullPaths |
Opcjonalny Boolean parametru. Jeśli true, określa ścieżkę bezwzględną do pliku w dane wyjściowe kompilatora.Jeśli false, określa nazwę pliku.Wartością domyślną jest false.Aby uzyskać więcej informacji, zobacz /fullpaths (opcje kompilatora C#). |
KeyContainer |
Opcjonalny String parametru. Określa nazwę kontenera klucza kryptograficznego.Aby uzyskać więcej informacji, zobacz /keycontainer (opcje kompilatora C#). |
KeyFile |
Opcjonalny String parametru. Określa nazwę pliku zawierającego klucz kryptograficzny.Aby uzyskać więcej informacji, zobacz /keyfile (opcje kompilatora C#). |
LangVersion |
Opcjonalny String parametru. Określa wersję język.Aby uzyskać więcej informacji, zobacz /langversion (opcje kompilatora C#). |
LinkResources |
Opcjonalny ITaskItem[] parametru. Tworzy łącze do .NET Framework zasobów w pliku wyjściowym; Plik zasobów nie jest umieszczony w pliku wyjściowym. Elementy do tego parametru może mieć wpisy opcjonalne metadanych o nazwie LogicalName i Access.LogicalNameodpowiada identifier parametr /linkresource przełączyć, a Access odpowiada accessibility-modifier parametru.Aby uzyskać więcej informacji, zobacz /linkresource (opcje kompilatora C#). |
MainEntryPoint |
Opcjonalny String parametru. Określa lokalizację Main metody.Aby uzyskać więcej informacji, zobacz /main (opcje kompilatora C#). |
ModuleAssemblyName |
Opcjonalny String parametru. Określa nazwę zestawu, że moduł ten będzie częścią. |
NoConfig |
Opcjonalny Boolean parametru. Jeśli true, informuje kompilator nie do kompilacji z pliku csc.rsp.Aby uzyskać więcej informacji, zobacz /noconfig (opcje kompilatora C#). |
NoLogo |
Opcjonalny Boolean parametru. Jeśli true, wyłącza wyświetlanie informacje transparentu kompilatora.Aby uzyskać więcej informacji, zobacz /nologo (opcje kompilatora C#). |
NoStandardLib |
Opcjonalny Boolean parametru. Jeśli true, przywóz mscorlib.dll, który definiuje cały obszar nazw systemu.Należy używać tego parametru, jeśli chcesz zdefiniować lub tworzenie własnych nazw systemu i obiektów.Aby uzyskać więcej informacji, zobacz /nostdlib (opcje kompilatora C#). |
NoWin32Manifest |
Opcjonalny Boolean parametru. Jeśli true, nie obejmują manifest domyślnego systemu Win32. |
Optimize |
Opcjonalny Boolean parametru. Jeśli true, umożliwia optymalizację.Jeśli false, wyłącza optymalizacje.Aby uzyskać więcej informacji, zobacz /optimize (opcje kompilatora C#). |
OutputAssembly |
Opcjonalny String parametr wyjścia. Określa nazwę pliku wyjściowego.Aby uzyskać więcej informacji, zobacz /out (opcje kompilatora C#). |
PdbFile |
Opcjonalny String parametru. Określa nazwę pliku informacji debugowania.Domyślną nazwą jest nazwa pliku wyjściowego z rozszerzeniem .pdb. |
Platform |
Opcjonalny String parametru. Określa platformy procesora, do których skierowane pliku wyjściowego.Ten parametr może mieć wartość x86, x64, lub anycpu.Wartością domyślną jest anycpu.Aby uzyskać więcej informacji, zobacz /platform (opcje kompilatora C#). |
References |
Opcjonalny ITaskItem[] parametru. Powoduje, że zadanie do importowania informacji typu publicznego z określone elementy do bieżącego projektu.Aby uzyskać więcej informacji, zobacz /reference (opcje kompilatora C#). Można określić Visual C# odniesienia aliasu w MSBuild pliku przez dodawanie metadanych Aliases do oryginalnego elementu "Odniesienia".Na przykład, aby ustawić następujący wiersz polecenia CSC aliasu "LS1": można użyć: |
Resources |
Opcjonalny ITaskItem[] parametru. Osadza .NET Framework zasobów do pliku wyjściowego. Elementy do tego parametru może mieć wpisy opcjonalne metadanych o nazwie LogicalName i Access.LogicalNameodpowiada identifier parametr /resource przełączyć, a Access odpowiada accessibility-modifier parametru.Aby uzyskać więcej informacji, zobacz /resource (opcje kompilatora C#). |
ResponseFiles |
Opcjonalny String parametru. Określa plik odpowiedzi, który zawiera polecenia służące do tego zadania.Aby uzyskać więcej informacji, zobacz @ (opcje kompilatora C#). |
Sources |
Opcjonalny ITaskItem[] parametru. Określa jedną lub więcej Visual C# pliki źródłowe. |
TargetType |
Opcjonalny String parametru. Określa format pliku wyjściowego.Ten parametr może mieć wartość library, który tworzy biblioteki kodu, exe, który tworzy aplikację konsoli, module, który tworzy moduł, lub winexe, który tworzy program systemu Windows.Wartością domyślną jest library.Aby uzyskać więcej informacji, zobacz /target (opcje kompilatora C#). |
TreatWarningsAsErrors |
Opcjonalny Boolean parametru. Jeśli true, traktuje wszystkie ostrzeżenia jako błędy.Aby uzyskać więcej informacji, zobacz /warnaserror (opcje kompilatora C#). |
UseHostCompilerIfAvailable |
Opcjonalny Boolean parametru. Nakazuje zadania użycia obiektu wewnątrzprocesowy kompilator, jeśli dostępne.Używane tylko przez Visual Studio. |
Utf8Output |
Opcjonalny Boolean parametru. Kompilator dzienniki wyjściowe przy użyciu kodowania UTF-8.Aby uzyskać więcej informacji, zobacz /utf8output (opcje kompilatora C#). |
WarningLevel |
Opcjonalny Int32 parametru. Określa poziom ostrzeżeń kompilatora wyświetlić.Aby uzyskać więcej informacji, zobacz /warn (opcje kompilatora C#). |
WarningsAsErrors |
Opcjonalny String parametru. Określa listę ostrzeżeń jako błędy.Aby uzyskać więcej informacji, zobacz /warnaserror (opcje kompilatora C#). Ten parametr zastępuje TreatWarningsAsErrors parametru. |
WarningsNotAsErrors |
Opcjonalny String parametru. Określa listę ostrzeżeń, które nie są traktowane jako błędy.Aby uzyskać więcej informacji, zobacz /warnaserror (opcje kompilatora C#). Ten parametr jest przydatny tylko jeśli TreatWarningsAsErrors ustawiono parametr true. |
Win32Icon |
Opcjonalny String parametru. Wstawia plik .ico zestawu, który daje żądany wygląd w Eksploratorze pliku plik wyjściowy.Aby uzyskać więcej informacji, zobacz /win32icon (opcje kompilatora C#). |
Win32Manifest |
Opcjonalny String parametru. Określa manifest Win32 dołączane. |
Win32Resource |
Opcjonalny String parametru. Wstawia plik wyjściowy pliku Win32 (.res) zasobu.Aby uzyskać więcej informacji, zobacz /win32res (opcje kompilatora C#). |
Uwagi
Oprócz parametrów wymienionych powyżej, to zadanie dziedziczy parametry z Microsoft.Build.Tasks.ManagedCompiler klasy, która dziedziczy z ToolTaskExtension , które sama klasa dziedziczy z ToolTask klasy.Listy te dodatkowe parametry i ich opisy, zobacz ToolTaskExtension — Klasa podstawowa.
Przykład
W poniższym przykładzie użyto Csc zadań skompilować plik wykonywalny z plików źródłowych w Compile element z kolekcji.
<CSC
Sources="@(Compile)"
OutputAssembly="$(AppName).exe"
EmitDebugInformation="true" />