Desainer Proyek .NET

Gunakan Project Designer untuk menentukan pengaturan dan properti proyek untuk .NET Core dan .NET 5+. Untuk .NET Framework, lihat Apa itu .NET Project Designer?.

Untuk mengakses Perancang Proyek, pilih simpul proyek (bukan simpul Solusi ) di Penjelajah Solusi. Lalu pilih PropertiProyek pada bilah menu. Project Designer muncul.

Note

Instruksi dalam artikel ini menggambarkan versi terbaru dari pengalaman pengembangan interaktif (IDE) yang tersedia di Visual Studio. Komputer Anda mungkin menampilkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna. Anda mungkin menggunakan versi 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.

Output type

Menentukan jenis aplikasi yang akan dibangun. Nilainya berbeda tergantung pada jenis proyek. Misalnya, untuk proyek Aplikasi Konsol , Anda dapat menentukan Windows Application, Console Application, atau Class Library 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.

Target Framework

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:

Note

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 ikhtisar penargetan Framework .

Target OS

Menentukan sistem operasi yang akan ditargetkan proyek. Dikombinasikan dengan kerangka kerja target, ini menghasilkan TF khusus OS .NET 5+.

Startup object

Menentukan titik masuk yang akan dipanggil saat aplikasi dimuat. Umumnya ini diatur baik ke formulir utama dalam aplikasi Anda atau ke prosedur Main 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 properti ke file .xaml dalam proyek Anda, seperti Window1.xaml. Untuk daftar elemen akar yang dapat diterima, lihat StartupUri. Anda juga harus menentukan metode public static void Main() di kelas dalam proyek. Kelas ini akan muncul dalam 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.

Assembly name

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.

Default namespace

Menentukan namespace layanan dasar untuk file yang ditambahkan ke proyek.

Lihat namespace untuk informasi selengkapnya tentang membuat namespace dalam kode Anda.

Untuk mengakses properti ini secara terprogram, lihat RootNamespace.

Pengaturan Aplikasi, Sumber Daya Win32

Icon

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 (Opsi Pengkompilasi C#) untuk informasi selengkapnya.

Untuk mengakses properti ini secara terprogram, lihat ApplicationIcon.

Untuk informasi tentang membuat ikon, lihat editor gambar untuk ikon.

Resources

Opsi Sumber Daya membantu Anda mengonfigurasi pengaturan sumber daya untuk aplikasi Anda. Secara default, Ikon dan opsi 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, maka 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.

Manifest

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 requestedExecutionLevelAsInvoker. Ini adalah opsi default.

• Buat aplikasi tanpamanifes . Metode ini dikenal sebagai virtualisasi. Gunakan opsi ini untuk kompatibilitas dengan aplikasi sebelumnya.

• Gunakanmanifes kustom . Memungkinkan Anda memasukkan jalur atau menelusuri manifes kustom untuk proyek.

Pengaturan Penggunaan Global

Implisit global menggunakan

Mengaktifkan atau menonaktifkan global menggunakan, 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).

Simbol Kustom Debug

Menentukan simbol untuk kompilasi kondisional untuk build Debug. Simbol debug default ditampilkan dalam string, dipisahkan oleh titik koma.

Simbol Kustom Rilis

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#).

Nullable

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 Nullable Contexts.

Menghasilkan info perakitan

Menentukan apakah properti proyek terkait paket diubah menjadi atribut perakitan. Untuk informasi selengkapnya, lihat properti GenerateAssemblyInfo.

Unsafe code

Memungkinkan kode yang menggunakan kata kunci tidak aman untuk dikompilasi. Untuk informasi selengkapnya, lihat /unsafe (C# Compiler Options).

Optimize code

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).

Debug symbols

Menentukan jenis informasi debugging yang dihasilkan oleh kompilator. Untuk informasi tentang cara mengonfigurasi performa debug aplikasi, lihat opsi DebugType compiler. Pengaturan ini memiliki opsi berikut:

• none

  Menentukan bahwa tidak ada informasi debug yang akan dihasilkan.

• full

  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.

• portable

  Menghasilkan . 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 bagaimana itu diproduksi. Lihat PDB Portabel untuk informasi selengkapnya.

• embedded

  Menyematkan informasi simbol portabel ke dalam rakitan. Tidak ada file .PDB eksternal yang diproduksi.

Untuk informasi selengkapnya, lihat /debug (Opsi Pengkompilasi C#).

Pengaturan build, Kesalahan, dan peringatan

Pengaturan berikut digunakan untuk mengonfigurasi opsi kesalahan dan peringatan untuk proses build.

Warning level

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 Anda tentukan. Namun, perintah Build dari menu Build menempatkannya di lokasi yang Anda tentukan. Untuk informasi selengkapnya, lihat Memahami Konfigurasi Build.

Reference assembly

Menentukan apakah akan menghasilkan rakitan referensi yang berisi API publik proyek.

Documentation file

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

Publishing

Memungkinkan target penerbitan MSBuild berjalan. Untuk informasi selengkapnya, lihat properti MSBuild IsPublishable.

Publish trimmed

Menentukan apakah pemangkasan diaktifkan selama proses penerbitan. Untuk informasi selengkapnya, lihat Properti terkait Trim.

Terbitkan AOT asli

Menentukan apakah akan menghasilkan aplikasi yang mandiri dan yang telah dikompilasi ke kode asli sebelumnya (AOT). Untuk informasi selengkapnya, lihat AOT Native deployment.

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 menggunakanProject Designer , lihat Cara: Menandatangani Assembly (Visual Studio). Untuk informasi selengkapnya, lihat Strong-named assemblies.

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 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

Pilih kotak centang ini untuk mengaktifkan penandatanganan penundaan. Untuk informasi selengkapnya, lihat Menunda penandatanganan rakitan.

Perhatikan bahwa proyek yang ditandatangani tertunda tidak akan berjalan dan tidak dapat di-debug. Namun, Anda dapat menggunakan Sn.exe (Alat Nama Kuat) dengan opsi untuk melewati verifikasi selama pengembangan.

Note

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 tertunda atau penandatanganan parsial untuk memberikan kunci publik, menunda penambahan kunci privat hingga assembly diserahkan.

Build, Pengaturan tingkat lanjut

Opsi berikut memungkinkan Anda mengatur pengaturan build tingkat lanjut.

Language version

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 diperiksa atau kata kunci yang tidak dicentang dan yang menghasilkan nilai di luar rentang jenis data akan menyebabkan pengecualian run-time. Untuk informasi selengkapnya, lihat -checked (Opsi Pengompilasi C#).

Deterministic

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 ke perintah (default), Anda akan menerima perintah jika terjadi kesalahan kompilator internal, memberi Anda opsi untuk mengirim laporan kesalahan secara elektronik ke Microsoft. Jika diatur ke 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).

File Alignment

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

Package License

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.

Analysis level

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 launchSettings.json proyek. Untuk informasi terperinci tentang bagaimana file ini digunakan dalam pengembangan ASP.NET, lihat Pengembangan dan launchSettings.json.

Sumber daya, Pengaturan umum

Pilih tautan untuk membuka file sumber daya rakitan RESX. Untuk informasi selengkapnya, lihat halaman Pengaturan , Perancang Proyek.

See also

UI Properti Proyek yang Di-revamped