Opsi pengkompilasi C#

Bagian ini menjelaskan opsi yang ditafsirkan oleh pengkompilasi C#. Opsi dikelompokkan ke dalam artikel terpisah berdasarkan apa yang mereka kontrol, misalnya, fitur bahasa, pembuatan kode, dan output. Gunakan daftar isi untuk menavigasi di antaranya.

Cara mengatur opsi

Ada dua cara berbeda untuk mengatur opsi pengkompilasi dalam proyek .NET:

• Dalam file *.csproj Anda

  Anda dapat menambahkan properti MSBuild untuk opsi pengkompilasi apa pun dalam file *.csproj Anda dalam format XML. Nama properti sama dengan opsi pengkompilasi. Nilai properti menetapkan nilai opsi pengkompilasi. Misalnya, cuplikan file proyek berikut mengatur LangVersion properti .

  <PropertyGroup>
    <LangVersion>preview</LangVersion>
  </PropertyGroup>
  

  Untuk informasi selengkapnya tentang mengatur opsi dalam file proyek, lihat artikel Properti MSBuild untuk Proyek .NET SDK.

• Menggunakan halaman Properti Visual Studio

  Visual Studio menyediakan halaman properti untuk mengedit properti build. Untuk mempelajari selengkapnya tentang properti tersebut, lihat Mengelola properti proyek dan solusi - Windows atau Mengelola properti proyek dan solusi - Mac.

Proyek .NET Framework

Penting

Bagian ini hanya berlaku untuk proyek .NET Framework.

Selain mekanisme yang dijelaskan di atas, Anda dapat mengatur opsi pengkompilasi menggunakan dua metode tambahan untuk proyek .NET Framework:

• Argumen baris perintah untuk proyek .NET Framework: proyek .NET Framework menggunakan csc.exe alih-alih dotnet build membangun proyek. Anda dapat menentukan argumen baris perintah untuk csc.exe untuk proyek .NET Framework.
• Halaman ASP.NET yang dikompilasi: Proyek .NET Framework menggunakan bagian file web.config untuk mengkompilasi halaman. Untuk sistem build baru, dan ASP.NET proyek Core, opsi diambil dari file proyek.

Kata untuk beberapa opsi pengkompilasi berubah dari proyekcsc.exe dan .NET Framework ke sistem MSBuild baru. Sintaks baru digunakan di seluruh bagian ini. Kedua versi tercantum di bagian atas setiap halaman. Untuk csc.exe, argumen apa pun tercantum mengikuti opsi dan titik dua. Misalnya, opsinya -doc adalah:

-doc:DocFile.xml

Anda dapat memanggil pengkompilasi C# dengan mengetik nama file yang dapat dieksekusi (csc.exe) pada prompt perintah.

Untuk proyek .NET Framework, Anda juga dapat menjalankan csc.exe dari baris perintah. Setiap opsi kompilator tersedia dalam dua bentuk: -option dan /option. Dalam proyek web .NET Framework, Anda menentukan opsi untuk mengkompilasi code-behind dalam file web.config . Untuk informasi selengkapnya, lihat <compiler> Element.

Jika Anda menggunakan jendela Perintah Pengembang untuk Visual Studio , semua variabel lingkungan yang diperlukan diatur untuk Anda. Untuk informasi tentang cara mengakses alat ini, lihat Perintah Pengembang untuk Visual Studio.

File csc.exe yang dapat dieksekusi biasanya terletak di folder Microsoft.NET\Framework\<Version> di bawah direktori Windows . Lokasinya mungkin bervariasi tergantung pada konfigurasi yang tepat dari komputer tertentu. Jika lebih dari satu versi .NET Framework diinstal di komputer Anda, Anda akan menemukan beberapa versi file ini. Untuk informasi selengkapnya tentang penginstalan tersebut, lihat Cara: menentukan versi .NET Framework mana yang diinstal.