C# hata ayıklama yapılandırmaları için proje ayarları (.NET Core, .NET 5+ ve ASP.NET Core)
Proje özellik sayfalarının Hata Ayıklama sekmesi ve Derleme sekmesi C# proje hata ayıklama ayarlarını değiştirebilirsiniz.
Özellik sayfalarını açmak için,
Daha fazla bilgi için bkz.hata ayıklama ve sürüm yapılandırmaları
Önemli
Bu ayarlar .NET Framework veya UWP uygulamaları için geçerli değildir. .NET Framework için hata ayıklama ayarlarını yapılandırmak için bkz. C# hata ayıklama yapılandırmaları için Proje ayarları.
Hata ayıklama sekmesi
Visual Studio 2022'den başlayarak, başlatma profilleri kullanıcı arabirimini açmak ve hata ayıklama ayarlarını değiştirmek için Hata Ayıklama sekmesinde hata ayıklama başlatma profilleri kullanıcı arabirimini aç
Başlatma profili (.NET Core, .NET 5+)
| Ayar | Açıklama |
|---|---|
| komut satırı bağımsız değişkenlerini |
Hata ayıklanan uygulama için komut satırı parametrelerini belirtir. Komut adı, Dış programı başlatiçinde belirtilen uygulama adıdır. |
| çalışma dizini | Hata ayıklanan uygulamanın çalışma dizinini belirtir. C# dilinde çalışma dizini varsayılan olarak \bin\debug |
| Uzak makineyi kullan | Uzaktan hata ayıklama için bu seçeneği belirleyin ve uzaktan hata ayıklama hedefinin adını veya bir Msvsmon sunucu adınıgirin. Uzak makinedeki bir uygulamanın konumu, Derleme sekmesindeki Çıkış Yolu özelliği tarafından belirtilir. Konum, uzak makinede paylaşılabilir bir dizin olmalıdır. |
| Ortam değişkenleri | Uygulama işlemini çalıştırmadan önce ortam değişkenlerini ayarlar. ASP.NET Core için bkz. Çalışma Ortamları. |
| Yönetilmeyen kod hata ayıklamasını etkinleştirme | Yönetilen uygulamadan yerel (yönetilmeyen) Win32 koduna yapılan çağrılarda hata ayıklar. |
| SQL Server hata ayıklamasını etkinleştirme | SQL Server veritabanı nesnelerinde hata ayıklar. |
| WebView2 hata ayıklamasını etkinleştirme | Microsoft Edge (Chromium) tabanlı hata ayıklayıcı ile JavaScript hatalarını ayıklar. |
Başlatma profili (ASP.NET Core)
.NET 5+ özelliklerine ek olarak, ASP.NET Core başlatma profilleri farklı ASP.NET Core profilleri için birkaç ek özellik içerir. Bu ayarlar projenin launchSettings.json dosyası için basit bir kullanıcı arabirimi sağlar. Bu dosya hakkında daha fazla bilgi için ASP.NET Core'da birden çok ortam kullanma
Başlatma profilleri kullanıcı arabiriminde sağlanan ayarlar aşağıdakileri içerir.
| Ayar | Açıklama |
|---|---|
| tarayıcıyı başlat | Url ayarında ayarladığınız URL'yi kullanarak hata ayıklamaya başladığınızda varsayılan tarayıcının başlatılıp başlatılmayacağını seçin. |
| Url | .NET veya .NET Core için ana bilgisayar URL'sinin konumunu belirtir. Projeye adını veren bir profil için (yani, launchSettings.json'daki commandName özelliği Proje), Kestrel sunucusu belirtilen bağlantı noktasını dinler. Iis profili için bu genellikle Uygulama URL'siile aynıdır. Daha fazla bilgi için proje konfigürasyonunun altındakiIIS başlatma profili bölümüne bakın. |
| Uygulama URL'si | Uygulama URL'lerini belirtir. Proje adını alan bir profil için, bu özellik Kestrel sunucu URL'lerini (genellikle https://localhost:5001 ve http://localhost:5000) belirtir. |
Visual Studio varsayılan olarak bir IIS Express profili sağlar ve IIS profili gibi ek profiller oluşturabilirsiniz. Bu ayarlar launchSettings.jsonayarlarına da karşılık gelir. Bu iki profil türü Barındırma modeli gibi çeşitli ayarlar sağlar.
| Ayar | Açıklama |
|---|---|
| Barındırma modeli | İşlemDe (varsayılan) veya İşlem Dışı seçeneğini belirtin. Daha fazla bilgi için bkz. ASP.NET Core belgelerinde barındırma modelleri |
| Uygulama SSL URL'si | IIS Express için Uygulama SSL URL'si genellikle http://localhost:44334. |
Derleme sekmesi
Aşağıdaki tabloda hata ayıklama için yararlı olan derleme ayarları gösterilmektedir. Derleme ayarlarının tam açıklaması için bkz. Derleme Sayfası, Proje Tasarımcısı.
| Ayarlar | Açıklama |
|---|---|
| Genel>Koşullu derleme simgeleri | Seçiliyse DEBUG ve TRACE sabitlerini tanımlayın. Bu sabitler, Debug sınıfı ve Trace sınıfıkoşullu derlemesini sağlar. Bu sabitler tanımlandığında, Hata Ayıklama ve İzleme sınıfı yöntemleri Çıktı penceresine çıktı üretir. Bu sabitler olmadan Hata Ayıklama ve İzleme sınıfı yöntemleri derlenmez ve çıkış oluşturulmaz. GENELLIKLE DEBUG, derlemenin Hata ayıklama sürümünde tanımlanır ve Sürüm sürümünde tanımlanmamıştır. TRACE hem Debug hem de Release sürümlerinde tanımlanır. |
| Genel>Kodu optimize et | Bir hata yalnızca iyileştirilmiş kodda görüntülenmediği sürece, Hata ayıklama derlemeleri için bu ayarın seçimi kaldırılsın. Yönergeler doğrudan kaynak koddaki deyimlere karşılık olmadığından iyileştirilmiş kodun hatalarını ayıklamak daha zordur. |
| Hata ayıklama simgeleri | Derleyici tarafından oluşturulan hata ayıklama bilgilerinin türünü belirtir. Bkz. |
| Çıktı>Temel çıkış yolu | Ara çıkış için temel klasörü belirtir. Çıkış genellikle hata ayıklama derlemeleri için bin\Debug konumuna yazılır. |
| Çıktı>Temel ara çıkış yolu | Ara çıkış için temel klasörü belirtir. Çıkış, genellikle bir hata ayıklama derlemesi için obj\Debug dizinine gider. |
Hata ayıklama simgeleri
Hata ayıklama simgeleri için aşağıdaki seçenekleri belirleyebilirsiniz.
Hiçbir simge yayılmıyor
Hata ayıklama bilgisinin oluşturulmayacağını belirtir.
PDB dosyası, geçerli platform
Bir .PDB dosyası üretir, bu platforma özgü bir sembol dosyasıdır ve diğer araçlara, özellikle hata ayıklayıcılara, ana yürütülebilir dosyada ne olduğu ve nasıl üretildiği hakkında bilgi sağlar.
PDB dosyası, taşınabilir
Platforma özgü olmayan, özellikle hata ayıklayıcılar için ana yürütülebilir dosyada ne olduğu ve nasıl oluşturulduğu hakkında bilgi sağlayan taşınabilir bir .PDB dosyası üretir. Daha fazla bilgi için bkz. Taşınabilir PDB
. DLL/EXE'ye katıştırılmış, platformlar arasında taşınabilir
Taşınabilir simge bilgilerini derlemeye ekler. Harici bir .PDB dosyası üretilmez.
Daha fazla bilgi için bkz. /debug (C# Derleyici Seçenekleri).