.NET Project Designer (C#)
Gunakan Perancang Proyek untuk menentukan pengaturan dan properti proyek untuk .NET Core dan .NET 5+. Untuk proyek .NET Framework dan Visual Basic, lihat Apa itu .NET Project Designer?.
Untuk mengakses Perancang Proyek, pilih simpul proyek (bukan node Solusi) di Penjelajah Solusi. Lalu pilih Properti Proyek>pada bilah menu. Perancang Proyek muncul.
Catatan
Komputer Anda mungkin menampilkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam artikel ini. Anda mungkin menggunakan edisi Visual Studio yang berbeda atau pengaturan lingkungan yang berbeda. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.
Aplikasi, Pengaturan umum
Opsi berikut memungkinkan Anda mengonfigurasi pengaturan umum untuk aplikasi.
Jenis output
Menentukan jenis aplikasi yang akan dibangun. Nilainya berbeda tergantung pada jenis proyek. Misalnya, untuk proyek Aplikasi Konsol, Anda dapat menentukan Aplikasi Windows, Aplikasi Konsol, atau Pustaka Kelas sebagai jenis output.
Untuk informasi selengkapnya tentang properti Jenis output, lihat /target (Opsi Pengkompilasi C#).
Untuk informasi tentang cara mengakses properti ini secara terprogram, lihat OutputType.
Kerangka Target
Menentukan versi .NET yang ditargetkan aplikasi. Opsi ini dapat memiliki nilai yang berbeda tergantung pada versi .NET mana yang diinstal di komputer Anda.
Untuk proyek yang menargetkan .NET Core atau .NET 5+, versi yang tersedia mungkin muncul sebagai berikut:
Catatan
Untuk aplikasi ClickOnce, paket prasyarat yang tercantum dalam Kotak Dialog Prasyarat diatur secara otomatis saat pertama kali Anda membuka kotak dialog. Jika Anda kemudian mengubah kerangka kerja target proyek, Anda harus memilih prasyarat secara manual agar sesuai dengan kerangka kerja target baru.
Untuk informasi selengkapnya, lihat Gambaran umum penargetan kerangka kerja.
Target OS
Menentukan sistem operasi yang akan ditargetkan proyek. Dikombinasikan dengan kerangka kerja target, ini menghasilkan TF khusus OS .NET 5+.
Objek startup
Menentukan titik masuk yang akan dipanggil saat aplikasi dimuat. Umumnya ini diatur baik ke formulir utama dalam aplikasi Anda atau ke Main
prosedur yang harus berjalan ketika aplikasi dimulai. Karena pustaka kelas tidak memiliki titik masuk, satu-satunya opsi untuk properti ini adalah (Tidak diatur).
Secara default, dalam proyek aplikasi WPF, opsi ini diatur ke (Tidak diatur). Opsi lainnya adalah [projectname].App. Dalam proyek WPF, Anda harus mengatur URI startup untuk memuat sumber daya UI saat aplikasi dimulai. Untuk melakukan ini, buka file Application.xaml di proyek Anda dan atur StartupUri
properti ke file .xaml di proyek Anda, seperti Window1.xaml. Untuk daftar elemen akar yang dapat diterima, lihat StartupUri. Anda juga harus menentukan public static void Main()
metode di kelas dalam proyek. Kelas ini akan muncul di daftar objek Startup sebagai ProjectName.ClassName. Anda kemudian dapat memilih kelas sebagai objek startup.
Lihat /main (C# Compiler Options) untuk informasi selengkapnya. Untuk mengakses properti ini secara terprogram, lihat StartupObject.
Nama rakitan
Menentukan nama file output yang akan menyimpan manifes perakitan. Mengubah properti ini juga mengubah properti Nama Output.
Anda juga dapat membuat perubahan ini dari baris perintah dengan menggunakan /out (C# Compiler Options).
Untuk mengakses properti ini secara terprogram, lihat AssemblyName.
Namespace default
Menentukan namespace layanan dasar untuk file yang ditambahkan ke proyek.
Lihat namespace layanan untuk informasi selengkapnya tentang membuat namespace dalam kode Anda.
Untuk mengakses properti ini secara terprogram, lihat RootNamespace.
Pengaturan Aplikasi, Sumber Daya Win32
Ikon
Menyetel file .ico yang ingin Anda gunakan sebagai ikon program Anda. Klik Telusuri untuk menelusuri grafik yang sudah ada, atau ketik nama file yang Anda inginkan. Lihat /win32icon (C# Compiler Options) untuk informasi selengkapnya.
Untuk mengakses properti ini secara terprogram, lihat ApplicationIcon.
Untuk informasi tentang membuat ikon, lihat Editor gambar untuk ikon.
Sumber
Opsi Sumber Daya membantu Anda mengonfigurasi pengaturan sumber daya untuk aplikasi Anda. Secara default, opsi Ikon dan Manifes diaktifkan. Ini memungkinkan Anda memilih ikon Anda sendiri atau memilih opsi pembuatan manifes yang berbeda. Biarkan tombol radio ini dipilih kecuali Anda menyediakan file sumber daya untuk proyek.
Jika Anda memilih File sumber daya, konfigurasikan file sumber daya untuk proyek. Masukkan nama jalur atau gunakan tombol Telusuri untuk menambahkan file sumber daya Win32 ke proyek. Untuk informasi selengkapnya, lihat Membuat file sumber daya untuk aplikasi .NET.
Manifes
Memilih opsi pembuatan manifes saat aplikasi berjalan di Windows di bawah Kontrol Akun Pengguna (UAC). Opsi ini dapat memiliki nilai berikut:
Sematkan manifes dengan pengaturan default. Mendukung cara umum di mana Visual Studio beroperasi di Windows, yaitu menyematkan informasi keamanan dalam file yang dapat dieksekusi aplikasi, menentukan bahwa menjadi
requestedExecutionLevel
AsInvoker
. Ini adalah opsi default.Buat aplikasi tanpa manifes. Metode ini dikenal sebagai virtualisasi. Gunakan opsi ini untuk kompatibilitas dengan aplikasi sebelumnya.
Gunakan manifes kustom. Memungkinkan Anda memasukkan jalur atau menelusuri manifes kustom untuk proyek.
Pengaturan Penggunaan Global
Penggunaan global implisit
Mengaktifkan atau menonaktifkan penggunaan global, yang memungkinkan Anda menggunakan jenis yang ditentukan dalam namespace tanpa menentukan namespace yang sepenuhnya memenuhi syarat.
Mengelola Penggunaan Global Implisit
Tambahkan dan hapus penggunaan global secara manual untuk digunakan dalam proyek Anda.
Build, Pengaturan umum
Simbol kompilasi bersyarah
Menentukan simbol untuk melakukan kompilasi kondisional. Pisahkan simbol dengan titik koma (";"). Untuk informasi selengkapnya, lihat /define (C# Compiler Options).
Debug Simbol Kustom
Menentukan simbol untuk kompilasi kondisional untuk build Debug. Simbol debug default ditampilkan dalam string, dipisahkan oleh titik koma.
Lepaskan Simbol Kustom
Menentukan simbol untuk kompilasi bersyarah untuk build Rilis. Simbol rilis default ditampilkan dalam string, dipisahkan oleh titik koma.
Platform Target
Menentukan prosesor yang akan ditargetkan oleh file output. Pilih x86 untuk prosesor yang kompatibel dengan Intel 32-bit, pilih x64 untuk prosesor yang kompatibel dengan Intel 64-bit, pilih ARM untuk prosesor ARM, atau pilih CPU apa pun untuk menentukan bahwa prosesor apa pun dapat diterima. CPU apa pun adalah nilai default untuk proyek, karena memungkinkan aplikasi berjalan pada rentang perangkat keras terluas.
Untuk informasi selengkapnya, lihat -platform (Opsi Pengompilasi C#).
Dapat diubah ke null
Menentukan konteks nullable C# di seluruh proyek. Opsi UI ini diperkenalkan di Visual Studio 16.5, dan hanya diaktifkan untuk proyek yang menggunakan C# 8.0 atau yang lebih baru.
Untuk informasi selengkapnya, lihat Konteks Nullable.
Membuat info perakitan
Menentukan apakah properti proyek terkait paket diubah menjadi atribut assembly. Untuk informasi selengkapnya, lihat properti GenerateAssemblyInfo .
Kode tidak aman
Memungkinkan kode yang menggunakan kata kunci yang tidak aman untuk dikompilasi. Untuk informasi selengkapnya, lihat /unsafe (C# Compiler Options).
Optimalkan kode
Aktifkan atau nonaktifkan pengoptimalan yang dilakukan oleh pengkompilasi untuk membuat file output Anda lebih kecil, lebih cepat, dan lebih efisien. Untuk informasi selengkapnya, lihat /optimize (C# Compiler Options).
Simbol debug
Menentukan jenis informasi penelusuran kesalahan yang dihasilkan oleh pengompilasi. Untuk informasi tentang cara mengonfigurasi performa debug aplikasi, lihat opsi pengkompilasi DebugType . Pengaturan ini memiliki opsi berikut:
Tidak ada
Menentukan bahwa tidak ada informasi penelusuran kesalahan yang akan dibuat.
Penuh
Memungkinkan melampirkan debugger ke program yang sedang berjalan.
pdbonly
Memungkinkan penelusuran kesalahan kode sumber ketika program dimulai di debugger tetapi hanya akan menampilkan perakit ketika program yang sedang berjalan dilampirkan ke debugger.
Portabel
Membuat file .PDB, file simbol portabel khusus non-platform yang menyediakan alat lain, terutama debugger, informasi tentang apa yang ada dalam file utama yang dapat dieksekusi dan cara pembuatannya. Lihat PDB portabel untuk informasi selengkapnya.
Tertanam
Menyematkan informasi simbol portabel ke dalam rakitan. Tidak ada file .PDB dibuat.
Untuk informasi selengkapnya, lihat /debug (Opsi Pengompilasi C#).
Pengaturan build, Kesalahan, dan peringatan
Pengaturan berikut digunakan untuk mengonfigurasi opsi kesalahan dan peringatan untuk proses build.
Tingkat peringatan
Menentukan tingkat yang akan ditampilkan untuk peringatan pengkompilasi. Untuk informasi selengkapnya, lihat -warn (opsi pengompilasi C#).
Menyembunyikan peringatan tertentu
Memblokir kemampuan kompilator untuk menghasilkan satu atau beberapa peringatan tertentu. Pisahkan beberapa angka peringatan dengan koma atau titik koma. Untuk informasi selengkapnya, lihat -nowarn (Opsi Pengompilasi C#).
Perlakukan peringatan sebagai kesalahan
Pilih apakah peringatan diperlakukan sebagai kesalahan selama proses build. Untuk informasi selengkapnya, lihat -warnaserror (opsi pengompilasi C#).
Perlakukan peringatan tertentu sebagai kesalahan
Tentukan peringatan mana yang diperlakukan sebagai kesalahan. Pisahkan beberapa angka peringatan dengan koma atau titik koma.
Tip
Jika Anda tidak ingin peringatan analisis kode diperlakukan sebagai kesalahan, lihat Tanya Jawab Umum analisis kode.
Build, Pengaturan output
Pengaturan berikut digunakan untuk mengonfigurasi opsi output untuk proses build.
Jalur output dasar
Menentukan lokasi file output untuk konfigurasi proyek ini. Masukkan jalur output build dalam kotak ini, atau pilih tombol Telusuri untuk menentukan jalur. Jalurnya relatif; jika Anda memasukkan jalur absolut, jalur tersebut akan disimpan sebagai relatif. Jalur default adalah bin\Debug atau bin\Release\.
Dengan konfigurasi build yang disederhanakan, sistem proyek menentukan apakah akan membuat versi debug atau rilis. Perintah Build dari menu Debug (F5) akan menempatkan build di lokasi debug terlepas dari jalur Output yang Anda tentukan. Namun, perintah Build dari menu Build menempatkannya di lokasi yang Anda tentukan. Untuk informasi selengkapnya, lihat Memahami Konfigurasi Build.
Rakitan referensi
Menentukan apakah akan menghasilkan rakitan referensi yang berisi API publik proyek.
File dokumentasi
Menentukan nama file tempat komentar dokumentasi akan diproses. Untuk informasi selengkapnya, lihat -doc (Opsi Pengompilasi C#).
Build, Pengaturan peristiwa
Untuk informasi tentang pengaturan peristiwa build, lihat Menentukan peristiwa build (C#).
Membangun, Menerbitkan pengaturan
Menerbitkan
Memungkinkan target penerbitan MSBuild berjalan. Untuk informasi selengkapnya, lihat properti MSBuild IsPublishable .
Terbitkan dipangkas
Menentukan apakah pemangkasan diaktifkan selama proses penerbitan. Untuk informasi selengkapnya, lihat Memangkas properti terkait.
Menerbitkan AOT asli
Menentukan apakah akan menghasilkan aplikasi yang mandiri dan yang telah dikompilasi ke kode asli sebelumnya (AOT). Untuk informasi selengkapnya, lihat Penyebaran AOT asli.
Build, Pengaturan penamaan yang kuat
Menandatangani assembly
Pilih kotak centang ini untuk menandatangani rakitan dan membuat file kunci yang sangat bernama. Untuk informasi selengkapnya tentang menandatangani rakitan dengan menggunakan Perancang Proyek, lihat Cara: Menandatangani Assembly (Visual Studio). Untuk mengetahui informasi selengkapnya, lihat Rakitan bernama kuat.
Opsi ini menggunakan alat Al.exe yang disediakan oleh Windows Software Development Kit (SDK) untuk menandatangani rakitan. Untuk informasi selengkapnya tentang Al.exe, lihat Cara: Menandatangani Assembly dengan Nama Kuat.
Daftar file kunci nama yang kuat
Memungkinkan Anda menentukan file kunci bernama baru atau yang sudah ada yang digunakan untuk menandatangani rakitan. Pilih <Telusuri...> untuk memilih file kunci yang ada.
Tanda penundaan saja
Pilih kotak centang ini untuk mengaktifkan penandatanganan penundaan. Untuk informasi selengkapnya, lihat Menunda-menandatangani assembly.
Perhatikan bahwa proyek yang ditandatangani tertunda tidak akan berjalan dan tidak dapat di-debug. Namun, Anda dapat menggunakan Sn.exe (Alat Nama Kuat) dengan -Vr
opsi untuk melewati verifikasi selama pengembangan.
Catatan
Saat menandatangani rakitan, Anda mungkin tidak selalu memiliki akses ke kunci privat. Misalnya, organisasi mungkin memiliki pasangan kunci yang dijaga ketat yang tidak dapat diakses pengembang setiap hari. Kunci publik mungkin tersedia, tetapi akses ke kunci privat dibatasi untuk beberapa individu. Dalam kasus seperti itu, Anda dapat menggunakan penandatanganan tertunda atau parsial untuk memberikan kunci umum, menunda penambahan kunci privat hingga assembly diserahkan.
Build, Pengaturan tingkat lanjut
Opsi berikut memungkinkan Anda mengatur pengaturan build tingkat lanjut.
Versi bahasa
Tautan ke /langversion (opsi pengkompilasi C#), yang menyediakan informasi tentang bagaimana versi bahasa default dipilih berdasarkan kerangka kerja target proyek.
Periksa luapan aritmatika
Menentukan apakah pernyataan aritmatika bilangan bulat yang tidak berada dalam cakupan kata kunci yang dicentang atau tidak dicentang dan yang menghasilkan nilai di luar rentang jenis data akan menyebabkan pengecualian run-time. Untuk informasi selengkapnya, lihat -checked (Opsi Pengompilasi C#).
Deterministik
Menentukan apakah akan menghasilkan output setara byte-for-byte dari sumber input yang sama. Untuk informasi selengkapnya, lihat Opsi Pengkompilasi C# yang mengontrol pembuatan kode.
Pelaporan kesalahan kompilator internal
Menentukan apakah akan melaporkan kesalahan pengkompilasi ke Microsoft. Jika diatur untuk meminta (default), Anda akan menerima perintah jika terjadi kesalahan kompilator internal, memberi Anda opsi untuk mengirim laporan kesalahan secara elektronik ke Microsoft. Jika diatur untuk mengirim, laporan kesalahan akan dikirim secara otomatis. Jika diatur ke antrean, laporan kesalahan akan diantrekan. Jika diatur ke tidak ada, kesalahan hanya akan dilaporkan dalam output teks pengkompilasi. Untuk informasi selengkapnya, lihat /errorreport (C# Compiler Options).
Perataan File
Menentukan ukuran bagian dalam file output. Nilai yang valid adalah 512, 1024, 2048, 4096, dan 8192. Nilai-nilai ini diukur dalam byte. Setiap bagian akan diselaraskan pada batas yang merupakan kelipatan dari nilai ini, yang memengaruhi ukuran file output. Untuk informasi selengkapnya, lihat /filealign (C# Compiler Options).
Paket, Pengaturan umum
Properti di bagian ini digunakan untuk mengonfigurasi paket, umumnya sesuai dengan properti dalam file NuGet .nuspec . Untuk informasi selengkapnya, lihat file .nuspec.
Pengaturan Paket, Lisensi
Lisensi Paket
Menentukan apakah akan menyertakan ekspresi lisensi atau file lisensi dalam paket Anda. Untuk informasi selengkapnya, lihat elemen lisensi .
Paket, Pengaturan simbol
Menghasilkan paket simbol
Menentukan apakah akan membuat paket simbol untuk penelusuran kesalahan. Untuk informasi selengkapnya, lihat Membuat paket simbol (.snupkg).
Analisis Kode, Semua pengaturan penganalisis
Jalankan pada build
Menentukan apakah akan menjalankan analisis kode sumber saat Anda membangun proyek. Untuk informasi selengkapnya, lihat Menonaktifkan analisis kode sumber untuk .NET.
Jalankan pada analisis langsung
Menentukan apakah akan menjalankan analisis kode sumber langsung saat Anda membangun proyek. Untuk informasi selengkapnya, lihat Menonaktifkan analisis kode sumber untuk .NET.
Analisis Kode, pengaturan penganalisis .NET
Menerapkan gaya kode pada build
Menentukan apakah pelanggaran gaya kode .NET dilaporkan saat membangun proyek. Untuk informasi selengkapnya, lihat Menerapkan gaya kode pada build.
Mengaktifkan penganalisis .NET
Mengaktifkan atau menonaktifkan penganalisis .NET compiler platform (Roslyn). Untuk informasi selengkapnya, lihat Mengaktifkan atau menginstal penganalisis .NET pihak pertama.
Tingkat analisis
Menentukan kumpulan penganalisis yang akan dijalankan dalam proyek. Untuk informasi selengkapnya, lihat Bagian pembaruan terbaru di artikel gambaran umum analisis kode.
Debug, Pengaturan umum
Pilih tautan untuk membuka antarmuka pengguna profil peluncuran debug. UI ini memungkinkan Anda menambahkan dan mengonfigurasi profil yang berbeda untuk digunakan saat penelusuran kesalahan. Setiap nama profil muncul sebagai opsi mulai di daftar Mulai Penelusuran Kesalahan .
Untuk proyek ASP.NET Core, pengaturan di antarmuka pengguna profil peluncuran sesuai dengan pengaturan dalam file peluncuran Pengaturan.json proyek. Untuk informasi terperinci tentang bagaimana file ini digunakan dalam pengembangan ASP.NET, lihat Pengembangan dan peluncuran Pengaturan.json.
Sumber daya, Pengaturan umum
Pilih tautan untuk membuka file sumber daya rakitan RESX. Untuk informasi selengkapnya, lihat halaman Pengaturan, Project Designer.