Share via

C# hata ayıklama yapılandırmaları için proje ayarları (.NET Core, .NET 5+ ve ASP.NET Core)

  • Makale

C# proje hata ayıklama ayarlarını, proje özellik sayfalarının Hata Ayıklama sekmesinde ve Derleme sekmesinde değiştirebilirsiniz.

Özellik sayfalarını açmak için, Çözüm Gezgini'da projeyi seçin ve ardından Özellikler simgesini seçin veya projeye sağ tıklayıp Özellikler'i seç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ç'ı seçin.

Başlatma profili (.NET Core, .NET 5+)

Ayar Açıklama
Komut satırı bağımsız değişkenleri Hata ayıklanan uygulama için komut satırı bağımsız değişkenlerini belirtir. Komut adı, Dış programı başlat bölümünde 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 şeklindedir.
Uzak makineyi kullanma 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, Oluştur 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 . Ortamlar.
Yönetilmeyen kod hata ayıklamayı 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 launch Ayarlar.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 bölümündeki Geliştirme ve başlatma Ayarlar.json bölümüne bakın.

Başlatma profilleri kullanıcı arabiriminde sağlanan ayarlar aşağıdakileri içerir.

Ayar Açıklama
Tarayıcıyı başlatma Hata ayıklamaya başladığınızda Url ayarında ayarladığınız URL'yi kullanarak 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. Projenin adını taşıyan bir profil için (launch Ayarlar.json dosyasındaki commandName özelliği Project'tir), Kestrel sunucusu belirtilen bağlantı noktasını dinler. Iis profili için bu genellikle Uygulama URL'si ile aynı değerdir. Daha fazla bilgi için Projeyi yapılandırma altındaki IIS başlatma profili bölümüne bakın.
Uygulama URL'si Uygulama URL'lerini belirtir. Projeden sonra adlı bir profil için bu özellik kestrel sunucu URL'lerini (genellikle https://localhost:5001 ve) belirtir http://localhost:5000

Visual Studio varsayılan olarak bir IIS Express profili sağlar ve IIS profili gibi ek profiller oluşturabilirsiniz. Bu ayarlar launch Ayarlar.json dosyasındaki ayarlara 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 modelleri barındırma.
Uygulama SSL URL'si IIS Express için Uygulama SSL URL'si genelliklehttp://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ı, Project Tasarım Aracı.

Ayar Açıklama
Genel>Koşullu derleme simgeleri Seçiliyse DEBUG ve TRACE sabitlerini tanımlayın.

Bu sabitler Debug sınıfının ve trace sınıfının koşullu derlemesini etkinleştirir. Bu sabitler tanımlandığında, Hata Ayıklama ve İzleme sınıfı yöntemleri Çıkış penceresine çıkış oluşturur. 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 Hata Ayıklama hem de Yayın sürümlerinde tanımlanır.
Genel>İyileştirme kodu 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. Hata ayıklama simgeleri. Bir uygulamanın hata ayıklama performansını yapılandırma hakkında bilgi için bkz . Görüntüde Hata Ayıklamayı Kolaylaştırma.
Çıkış Temeli>çıkış yolu Ara çıkış için temel klasörü belirtir. Çıkış genellikle hata ayıklama derlemesi için bin\Debug dizinine gider.
Çıkış>Tabanı ara çıkış yolu Ara çıkış için temel klasörü belirtir. Çıkış genellikle hata ayıklama derlemesi için obj\Debug'a gider.

Hata ayıklama simgeleri

Hata ayıklama simgeleri için aşağıdaki seçenekleri belirleyebilirsiniz.

  • Hiçbir simge belirtilmez

    Hata ayıklama bilgilerinin oluşturulacağını belirtir.

  • PDB dosyası, geçerli platform

    Bir üretir. PDB dosyası, özellikle hata ayıklayıcılar, ana yürütülebilir dosyada ne olduğu ve nasıl oluşturulduğu hakkında bilgi sağlayan platforma özgü bir simge dosyasıdır.

  • PDB dosyası, taşınabilir

    Bir üretir. PdB dosyası, platforma özgü olmayan, özellikle hata ayıklayıcılar, ana yürütülebilir dosyada ne olduğu ve nasıl oluşturulduğu hakkında bilgi sağlayan taşınabilir simge dosyası. Daha fazla bilgi için bkz . Taşınabilir PDB .

  • DLL/EXE'ye eklenmiş, platformlar arasında taşınabilir

    Taşınabilir simge bilgilerini derlemeye ekler. Dış yok. PDB dosyası oluşturulur.

Daha fazla bilgi için bkz . /debug (C# Derleyici Seçenekleri).

Ayrıca bkz.