Tugas Csc

  • Artikel

Membungkus csc.exe, dan menghasilkan file yang dapat dieksekusi (.exe ), pustaka tautan dinamis ( file.dll), atau modul kode (file.netmodule). Untuk informasi selengkapnya tentang csc.exe, lihat opsi pengompilasi C#.

Parameter

Tabel berikut ini menjelaskan parameter tugas Csc.

Parameter Deskripsi
AdditionalLibPaths Parameter String[] opsional.

Menentukan direktori tambahan untuk mencari referensi. Untuk informasi selengkapnya, lihat -lib (opsi pengompilasi C#).
AddModules Parameter String opsional.

Menentukan satu atau beberapa modul untuk menjadi bagian dari perakitan. Untuk informasi selengkapnya, lihat -addmodule (opsi pengompilasi C#).
AllowUnsafeBlocks Parameter Boolean opsional.

Jika true, kompilasi kode yang menggunakan kata kunci yang tidak aman. Untuk informasi selengkapnya, lihat -unsafe (opsi pengompilasi C#).
ApplicationConfiguration Parameter String opsional.

Menentukan file konfigurasi aplikasi yang berisi pengaturan pengikatan perakitan.
BaseAddress Parameter String opsional.

Menentukan alamat dasar pilihan untuk memuat DLL. Alamat dasar default untuk DLL diatur oleh runtime bahasa umum .NET Framework. Untuk informasi selengkapnya, lihat -baseaddress (opsi pengompilasi C#).
CheckForOverflowUnderflow Parameter Boolean opsional.

Menentukan apakah aritmatika bilangan bulat yang melampaui batas tipe data menyebabkan pengecualian pada waktu proses. Untuk informasi selengkapnya, lihat -checked (opsi pengkompilasi C#).
ChecksumAlgorithm Parameter String opsional.

Menentukan algoritma untuk menghitung checksum file sumber yang disimpan dalam file PDB. Algoritma harus SHA1 (default) atau SHA256. Lihat ChecksumAlgorithm.
CodeAnalysisRuleset Parameter String opsional.

Menentukan file ruleset yang menonaktifkan diagnostik tertentu. Lihat CodeAnalysisRuleset.
CodePage Parameter Int32 opsional.

Menentukan halaman kode yang akan digunakan untuk semua file kode sumber di dalam kompilasi. Untuk informasi selengkapnya, lihat -codepage (opsi pengkompilasi C#).
DebugType Parameter String opsional.

Menentukan jenis debug. DebugType dapat berupa full atau pdbonly. Defaultnya adalah full, yang memungkinkan debugger dilampirkan ke program yang sedang berjalan. Menentukan pdbonly mengaktifkan penelusuran kesalahan kode sumber ketika program dimulai di debugger, tetapi hanya menampilkan perakit ketika program yang sedang berjalan dilampirkan ke debugger.

Parameter ini mengambil alih parameter EmitDebugInformation.

Untuk informasi selengkapnya, lihat -debug (opsi pengompilasi C#).
DefineConstants Parameter String opsional.

Mendefinisikan simbol pra-prosesor. Untuk informasi selengkapnya, lihat -define (C# compiler options).
DelaySign Parameter Boolean opsional.

Jika true, menentukan bahwa Anda hanya ingin menempatkan kunci umum di rakitan. Jika false, menentukan bahwa Anda menginginkan rakitan yang ditandatangani sepenuhnya

Parameter ini tidak berpengaruh kecuali digunakan dengan parameter KeyFile atau KeyContainer.

Untuk informasi selengkapnya, lihat -delaysign (opsi pengompilasi C#).
Deterministic Parameter Boolean opsional.

Jika true, menyebabkan pengompilasi mengeluarkan rakitan yang konten binernya identik di seluruh kompilasi jika input identik.

Untuk informasi selengkapnya, lihat -deterministik (opsi C# Compiler).
DisabledWarnings Parameter String opsional.

Menentukan daftar peringatan yang akan dinonaktifkan. Untuk informasi selengkapnya, lihat -nowarn (opsi pengompilasi C#).
DocumentationFile Parameter String opsional.

Memproses komentar dokumentasi ke file XML. Untuk informasi selengkapnya, lihat -doc (opsi pengkompilasi C#).
EmbedAllSources Parameter Boolean opsional.

Sematkan semua file sumber di PDB. Untuk informasi selengkapnya, lihat -embed (opsi pengompilasi C#)
EmitDebugInformation Parameter Boolean opsional.

Jika true, tugas menghasilkan informasi penelusuran kesalahan dan menempatkannya dalam file database program (.pdb). Jika false, tugas tidak memancarkan informasi debug. Defaultnya adalah false. Untuk informasi selengkapnya, lihat -debug (opsi pengompilasi C#).
ErrorLog Parameter String opsional.

Menentukan file untuk mencatat semua diagnostik pengkompilasi dan penganalisis. Lihat ErrorLog.
ErrorReport Parameter String opsional.

Menyediakan cara mudah untuk melaporkan kesalahan internal C# ke Microsoft. Parameter ini dapat memiliki nilai prompt, send, atau none. Jika parameter diatur ke prompt, Anda akan menerima perintah saat terjadi kesalahan pengompilasi internal. Perintah ini memungkinkan Anda mengirim laporan bug secara elektronik ke Microsoft. Jika parameter diatur ke send, laporan bug dikirim secara otomatis. Jika parameter diatur ke none, kesalahan hanya dilaporkan dalam output teks pengompilasi. Defaultnya adalah none. Untuk informasi selengkapnya, lihat -errorreport (opsi pengompilasi C#).
FileAlignment Parameter Int32 opsional.

Menentukan ukuran bagian dalam file output. Untuk informasi selengkapnya, lihat -filealign (opsi pengompilasi C#).
GenerateFullPaths Parameter Boolean opsional.

Jika true, menentukan jalur absolut ke file dalam output pengompilasi. Jika false, menentukan nama file. Defaultnya adalah false. Untuk informasi selengkapnya, lihat -fullpaths (opsi pengompilasi C#).
HighEntropyVA Parameter Boolean opsional

Aktifkan Pengacakan Tata Letak Ruang Alamat entropi tinggi (ASLR). Lihat HighEntropyVA.
KeyContainer Parameter String opsional.

Menentukan nama kontainer kunci kriptografi. Untuk informasi selengkapnya, lihat -keycontainer (opsi pengompilasi C#).
KeyFile Parameter String opsional.

Menentukan nama file yang berisi kunci kriptografi. Untuk informasi selengkapnya, lihat -keyfile (opsi pengompilasi C#).
LangVersion Parameter String opsional.

Menentukan versi bahasa yang akan digunakan. Untuk informasi selengkapnya, lihat -langversion (opsi pengompilasi C#).
LinkResources Parameter ITaskItem[] opsional.

Membuat link ke sumber daya .NET Framework di file output; file sumber tidak ditempatkan di file output.

Item yang diteruskan ke parameter ini dapat memiliki entri metadata opsional bernama LogicalName dan Access. LogicalName sesuai dengan parameter identifier dari sakelar /linkresource, dan Access sesuai dengan parameter accessibility-modifier. Untuk informasi selengkapnya, lihat -linkresource (opsi pengompilasi C#).
MainEntryPoint Parameter String opsional.

Menentukan lokasi metode Main. Untuk informasi selengkapnya, lihat -main (opsi pengompilasi C#).
ModuleAssemblyName Parameter String opsional.

Tentukan nama rakitan tempat modul ini akan menjadi bagiannya.
NoConfig Parameter Boolean opsional.

Jika true, memberi tahu kompilator untuk tidak mengompilasi dengan file csc.rsp. Untuk informasi selengkapnya, lihat -noconfig (opsi pengompilasi C#).
NoLogo Parameter Boolean opsional.

Jika true, menekan tampilan informasi banner pengompilasi. Untuk informasi selengkapnya, lihat -nologo (opsi pengompilasi C#).
NoStandardLib Parameter Boolean opsional.

Jika true, mencegah impor mscorlib.dll, yang menentukan seluruh namespace layanan Sistem. Gunakan parameter ini jika Anda ingin menentukan atau membuat namespace dan objek Sistem Anda sendiri. Untuk informasi selengkapnya, lihat -nostdlib (opsi pengompilasi C#).
NoWin32Manifest Parameter Boolean opsional.

Jika true, jangan sertakan manifes Win32 default.
Nullable Parameter String opsional.

Menentukan konteks nullable. Argumen harus merupakan salah satu dari enable, disable, warnings, atau annotations. Lihat Nullable.
Optimize Parameter Boolean opsional.

Jika true, mengaktifkan pengoptimalan. Jika false, menonaktifkan pengoptimalan. Untuk informasi selengkapnya, lihat -optimize (opsi pengkompilasi C#).
OutputAssembly Parameter output String opsional.

Menentukan nama file output. Untuk informasi selengkapnya, lihat -out (opsi pengompilasi C#).
OutputRefAssembly Parameter String opsional.

Menentukan nama file rakitan referensi output. Untuk informasi selengkapnya, lihat -refout (opsi pengompilasi C#).
PathMap Parameter String opsional.

Menentukan cara memetakan jalur fisik ke output nama jalur sumber oleh kompiler. Lihat PathMap.
PdbFile Parameter String opsional.

Menentukan nama file informasi debug. Nama default adalah nama file output dengan ekstensi .pdb.
Platform Parameter String opsional.

Menentukan platform prosesor yang akan ditargetkan oleh file output. Parameter ini dapat memiliki nilai x86, x64, atau anycpu. Defaultnya adalah anycpu. Untuk informasi selengkapnya, lihat -platform (opsi pengompilasi C#).
PreferredUILang Parameter String opsional.

Menentukan bahasa tempat pengkompilasi C# menampilkan output, seperti pesan kesalahan. Lihat PreferreduiLang.
PublicSign Parameter Boolean opsional.

Tanda tangani perakitan output secara publik. Lihat PublicSign.
References Parameter ITaskItem[] opsional.

Menyebabkan tugas mengimpor informasi jenis publik dari item yang ditentukan ke dalam proyek saat ini. Untuk informasi selengkapnya, lihat -referensi (opsi pengompilasi C#).

Anda dapat menentukan alias referensi C# dalam file MSBuild dengan menambahkan metadata Aliases ke item "Referensi" asli. Misalnya, untuk mengatur alias "LS1" di baris perintah Csc berikut:

CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs

Anda akan menggunakan:

<Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>
RefOnly Parameter Boolean opsional.

Menghasilkan rakitan referensi, alih-alih perakitan penuh, sebagai output utama. Lihat ProduceOnlyReferenceAssembly.
ReportAnalyzer Parameter Boolean opsional.

Melaporkan informasi penganalisis tambahan, seperti waktu eksekusi. Lihat ReportAnalyzer.
Resources Parameter ITaskItem[] opsional.

Menyematkan sumber daya .NET Framework ke dalam file output.

Item yang diteruskan ke parameter ini dapat memiliki entri metadata opsional bernama LogicalName dan Access. LogicalName sesuai dengan parameter identifier dari sakelar /resource, dan Access sesuai dengan parameter accessibility-modifier. Untuk informasi selengkapnya, lihat -resource (opsi pengompilasi C#).
ResponseFiles Parameter String opsional.

Menentukan file respons yang berisi perintah untuk tugas ini. Untuk informasi selengkapnya, lihat @ (Tentukan file respons).
Sources Parameter ITaskItem[] opsional.

Menentukan satu atau beberapa file sumber C#.
TargetType Parameter String opsional.

Menentukan format file dari file output. Parameter ini dapat memiliki nilai library, yang membuat pustaka kode, exe, yang membuat aplikasi konsol, module, yang membuat modul, atau winexe, yang membuat program Windows. Nilai defaultnya adalah library. Untuk informasi selengkapnya, lihat -target (opsi pengompilasi C#).
TreatWarningsAsErrors Parameter Boolean opsional.

Jika true, memperlakukan semua peringatan sebagai kesalahan. Untuk informasi selengkapnya, lihat -warnaserror (opsi pengompilasi C#).
UseHostCompilerIfAvailable Parameter Boolean opsional.

Menginstruksikan tugas untuk menggunakan objek pengompilasi dalam proses, jika tersedia. Hanya digunakan oleh Visual Studio.
Utf8Output Parameter Boolean opsional.

Mencatat output pengompilasi menggunakan pengodean UTF-8. Untuk informasi selengkapnya, lihat -utf8output (opsi pengompilasi C#).
WarningLevel Parameter Int32 opsional.

Menentukan tingkat peringatan untuk ditampilkan pengompilasi. Untuk informasi selengkapnya, lihat -warn (opsi pengompilasi C#).
WarningsAsErrors Parameter String opsional.

Menentukan daftar peringatan yang diperlakukan sebagai kesalahan. Untuk informasi selengkapnya, lihat -warnaserror (opsi pengompilasi C#).

Parameter ini mengambil alih parameter TreatWarningsAsErrors.
WarningsNotAsErrors Parameter String opsional.

Menentukan daftar peringatan yang tidak diperlakukan sebagai kesalahan. Untuk informasi selengkapnya, lihat -warnaserror (opsi pengompilasi C#).

Parameter ini hanya relevan jika parameter TreatWarningsAsErrors diatur ke true.
Win32Icon Parameter String opsional.

Menyisipkan file .ico di assembly, yang memberikan file output tampilan yang diinginkan dalam File Explorer. Untuk informasi selengkapnya, lihat -win32icon (opsi pengompilasi C#).
Win32Manifest Parameter String opsional.

Menentukan manifes Win32 yang akan disertakan.
Win32Resource Parameter String opsional.

Menyisipkan file sumber daya Win32 (.res) dalam file output. Untuk informasi selengkapnya, lihat -win32res (opsi pengompilasi C#).

Parameter ToolTaskExtension

Tugas ini mewarisi dari kelas ToolTaskExtension, yang mewarisi dari kelas ToolTask, yang mewarisi dari Task kelas itu sendiri. Rantai pewarisan ini menambahkan beberapa parameter ke tugas yang berasal dari tugas itu sendiri.

Tabel berikut ini menjelaskan parameter kelas dasar:

Parameter Deskripsi
EchoOff Parameter bool opsional.

Ketika diatur ke true, tugas ini meneruskan /Q ke baris perintahcmd.exe, sehingga baris perintah tidak disalin ke stdout.
EnvironmentVariables Parameter array String opsional.

Array definisi variabel lingkungan, dipisahkan oleh titik koma. Setiap definisi harus menentukan nama dan nilai variabel lingkungan yang dipisahkan oleh tanda sama dengan. Variabel-variabel ini diteruskan ke yang dapat dijalankan yang dihasilkan selain, atau secara selektif mengambil alih, blok lingkungan reguler. Misalnya, Variable1=Value1;Variable2=Value2.
ExitCode Parameter baca-saja output Int32 opsional.

Tentukan kode keluar yang disediakan oleh perintah yang dijalankan. Jika tugas mencatat kesalahan apa pun, tetapi prosesnya memiliki kode keluar 0 (berhasil), ini diatur ke -1.
LogStandardErrorAsError Parameter bool opsional.

Jika true, semua pesan yang diterima pada aliran kesalahan standar dicatat sebagai kesalahan.
StandardErrorImportance Parameter String opsional.

Pentingnya untuk mencatat teks dari aliran kesalahan standar.
StandardOutputImportance Parameter String opsional.

Pentingnya untuk mencatat teks dari aliran keluar standar.
Timeout Parameter Int32 opsional.

Menentukan jumlah waktu, dalam milidetik, yang setelahnya tugas yang dapat dieksekusi dihentikan. Nilai defaultnya adalah Int.MaxValue, menunjukkan bahwa tidak ada periode waktu habis. Waktu habis dalam milidetik.
ToolExe Parameter string opsional.

Proyek dapat menerapkan ini untuk mengambil alih ToolName. Tugas dapat mengambil alih ini untuk mempertahankan ToolName.
ToolPath Parameter string opsional.

Tentukan lokasi dari mana tugas memuat file eksekusi yang mendasarinya. Jika parameter ini tidak ditentukan, tugas menggunakan jalur penginstalan SDK yang sesuai dengan versi kerangka kerja yang menjalankan MSBuild.
UseCommandProcessor Parameter bool opsional.

Saat diatur ke true, tugas ini membuat file batch untuk baris perintah dan menjalankannya dengan menggunakan prosesor perintah alih-alih menjalankan perintah secara langsung.
YieldDuringToolExecution Parameter bool opsional.

Saat diatur ke true, tugas ini menghasilkan node saat tugasnya dijalankan.

Contoh

Contoh berikut menggunakan tugas Csc untuk mengompilasi file yang dapat dieksekusi dari file sumber dalam kumpulan item Compile.

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

Baca juga