Pengaturan proyek untuk konfigurasi debug C# (.NET Core, .NET 5+, dan ASP.NET Core)

Artikel
01/12/2024

Anda dapat mengubah pengaturan debug proyek C# di tab Debug dan tab Build halaman properti proyek.

Untuk membuka halaman properti, pilih proyek di Penjelajah Solusi lalu pilih ikon Properti, atau klik kanan proyek dan pilih Properti.

Untuk informasi selengkapnya, lihat Konfigurasi debug dan rilis.

Penting

Pengaturan ini tidak berlaku untuk aplikasi .NET Framework atau UWP. Untuk mengonfigurasi pengaturan debug untuk .NET Framework, lihat Pengaturan proyek untuk konfigurasi debug C#.

Tab Debug

Mulai Visual Studio 2022, pilih Buka antarmuka pengguna profil peluncuran debug di tab Debug untuk membuka antarmuka pengguna profil peluncuran dan mengubah pengaturan debug.

Luncurkan profil (.NET Core, .NET 5+)

Pengaturan	Deskripsi
Argumen baris perintah	Menentukan argumen baris perintah untuk aplikasi yang sedang di-debug. Nama perintah adalah nama aplikasi yang ditentukan dalam Mulai program eksternal.
Direktori kerja	Menentukan direktori kerja aplikasi yang sedang di-debug. Di C#, direktori kerja adalah \bin\debug secara default.
Menggunakan komputer jarak jauh	Untuk penelusuran kesalahan jarak jauh, pilih opsi ini dan masukkan nama target penelusuran kesalahan jarak jauh, atau nama server Msvsmon. Lokasi aplikasi pada komputer jarak jauh ditentukan oleh properti Jalur Output pada tab Build. Lokasi harus merupakan direktori yang dapat dibagikan pada komputer jarak jauh.
Variabel lingkungan	Mengatur variabel lingkungan sebelum menjalankan proses aplikasi. Untuk ASP.NET Core, lihat Lingkungan.
Mengaktifkan penelusuran kesalahan kode tak terkelola	Debug panggilan ke kode Win32 asli (tidak dikelola) dari aplikasi terkelola.
Mengaktifkan penelusuran kesalahan SQL Server	Men-debug objek database SQL Server.
Mengaktifkan penelusuran kesalahan WebView2	Men-debug JavaScript dengan debugger berbasis Microsoft Edge (Chromium).

Luncurkan profil (ASP.NET Core)

Selain properti untuk .NET 5+, profil peluncuran ASP.NET Core menyertakan beberapa properti tambahan untuk profil ASP.NET Core yang berbeda. Pengaturan ini menyediakan antarmuka pengguna sederhana untuk file launchSettings.json proyek. Untuk informasi selengkapnya tentang file ini, lihat bagian Pengembangan dan launchSettings.json di Menggunakan beberapa lingkungan di ASP.NET Core.

Pengaturan yang disediakan dalam antarmuka pengguna profil peluncuran mencakup yang berikut ini.

Pengaturan	Deskripsi
Meluncurkan browser	Pilih apakah akan meluncurkan browser default saat Anda memulai penelusuran kesalahan, menggunakan URL yang Anda tetapkan di pengaturan Url.
Url	Menentukan lokasi URL host untuk .NET atau .NET Core. Untuk profil yang dinamai sesuai dengan proyek (yaitu, properti commandName di launchSettings.json adalah Proyek), server Kestrel mendengarkan port yang ditentukan. Untuk profil IIS, ini biasanya nilai yang sama dengan URL Aplikasi. Untuk informasi selengkapnya, lihat bagian profil peluncuran IIS pada Konfigurasikan proyek.
URL Aplikasi	Menentukan URL aplikasi. Untuk profil yang dinamai sesuai dengan proyek, properti ini menentukan URL server Kestrel, biasanya https://localhost:5001 dan http://localhost:5000

Visual Studio menyediakan profil Ekspres IIS secara default, dan Anda dapat membuat profil tambahan seperti profil IIS. Pengaturan ini juga sesuai dengan pengaturan di launchSettings.json. Kedua jenis profil ini menyediakan beberapa pengaturan, seperti model Hosting.

Pengaturan	Deskripsi
Model hosting	Tentukan Dalam Proses (default) atau Di Luar Proses. Untuk informasi selengkapnya, lihat Model Hosting di dokumen ASP.NET Core.
URL SSL Aplikasi	Untuk IIS Express, URL SSL Aplikasi biasanya http://localhost:44334.

Tab Build

Tabel berikut ini memperlihatkan pengaturan build yang berguna untuk penelusuran kesalahan. Untuk penjelasan lengkap tentang pengaturan build, lihat Halaman Build, Perancang Proyek.

Pengaturan	Deskripsi
Umum>Simbol kompilasi bersyarat	Tentukan konstanta DEBUG dan TRACE jika dipilih. Konstanta ini memungkinkan kompilasi bersyarat dari kelas Debug dan kelas Pelacakan. Dengan konstanta ini ditentukan, metode kelas Debug dan Pelacakan menghasilkan output ke jendela Output. Tanpa konstanta ini, metode kelas Debug dan Pelacakan tidak dikompilasi, dan tidak ada output yang dihasilkan. Biasanya, DEBUG ditentukan dalam versi Debug dari build dan tidak ditentukan dalam versi Rilis. TRACE ditentukan dalam versi Debug dan Rilis.
Umum>Optimalkan kode	Kecuali bug hanya muncul dalam kode yang dioptimalkan, biarkan pengaturan ini tidak dipilih untuk build Debug. Kode yang dioptimalkan lebih sulit untuk di-debug, karena instruksi tidak sesuai langsung dengan pernyataan dalam kode sumber.
Simbol debug	Menentukan jenis informasi penelusuran kesalahan yang dihasilkan oleh pengompilasi. Lihat Simbol debug. Untuk informasi tentang cara mengonfigurasi performa debug aplikasi, lihat Membuat Gambar Lebih Mudah Di-debug.
Output>Jalur output dasar	Menentukan folder dasar untuk output perantara. Output biasanya masuk ke bin\Debug untuk build Debug.
Output>Jalur output perantara dasar	Menentukan folder dasar untuk output perantara. Output biasanya masuk ke obj\Debug untuk build Debug.

Simbol debug

Anda dapat memilih opsi berikut untuk simbol debug.

Tidak ada simbol yang dipancarkan

Menentukan bahwa tidak ada informasi penelusuran kesalahan yang akan dibuat.
File PDB, platform saat ini

Membuat file .PDB, file simbol khusus platform yang menyediakan alat lain, terutama debugger, informasi tentang apa yang ada dalam file utama yang dapat dieksekusi dan cara pembuatannya.
File PDB, 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.
Disematkan dalam DLL/EXE, portabel di seluruh platform

Menyematkan informasi simbol portabel ke dalam rakitan. Tidak ada file .PDB dibuat.

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

Bagikan melalui