Opsi pengkompilasi C#

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

Cara mengatur opsi

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

• Dalam file *.csproj Anda

  Anda bisa 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 opsi pengaturan dalam file proyek, lihat artikel Properti MSBuild untuk Proyek .NET SDK.

• Menggunakan halaman Visual Studio Property

  Visual Studio menyediakan halaman properti untuk mengedit properti build. Untuk mempelajari selengkapnya, 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 bisa menentukan argumen baris perintah untuk csc.exe untuk proyek .NET Framework.
• Halaman ASP.NET yang dikompilasi: proyek .NET Framework menggunakan bagian dari file web.config untuk mengkompilasi halaman. Untuk sistem build baru, dan proyek ASP.NET Core, opsi diambil dari file proyek.

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

-doc:DocFile.xml

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

Untuk proyek .NET Framework, Anda juga bisa menjalankan csc.exe dari baris perintah. Setiap opsi pengkompilasi tersedia dalam dua bentuk: -option dan /option. Dalam proyek web .NET Framework, Anda menentukan opsi untuk mengkompilasi kode di belakang pada file web.config. Untuk informasi selengkapnya, lihat <Compiler> Element.

Jika Anda menggunakan jendela Perintah Pengembang untuk Visual Studio, semua variabel lingkungan yang diperlukan telah 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> pada direktori Windows. Lokasinya mungkin bervariasi tergantung pada konfigurasi yang tepat dari komputer tertentu. Jika ada 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.