Visual Studio hata ayıklayıcısı ile çalışan işlemlere ekleme

Visual Studio hata ayıklayıcısını yerel veya uzak bir bilgisayarda çalışan bir işleme ekleyebilirsiniz. İşlem çalıştırıldıktan sonra İşlemeEkleme> seçin veya Visual Studio'da Ctrl+Alt+p tuşlarına basın ve hata ayıklayıcıyı işleme eklemek için İşleme Ekle iletişim kutusunu kullanın.

Yerel veya uzak bilgisayarlarda çalışan uygulamaların hatalarını ayıklamak, aynı anda birden çok işlemde hata ayıklamak, Visual Studio'da oluşturulmamış uygulamalarda hata ayıklamak veya Visual Studio'dan başlatmadığınız herhangi bir uygulamada hata ayıklayıcı ekli olarak hata ayıklamak için İşleme Ekle'yi kullanabilirsiniz. Örneğin, bir uygulamayı hata ayıklayıcı olmadan çalıştırıyorsanız ve bir özel durumla karşı karşıyaysanız, hata ayıklayıcıyı uygulamayı çalıştıran işleme ekleyebilir ve hata ayıklamaya başlayabilirsiniz.

İpucu

Hata ayıklama senaryonuz için İşleme Ekle'yi kullanıp kullanmayacağınız konusunda emin değil misiniz? Bkz. Yaygın hata ayıklama senaryoları.

Yerel makinenizde çalışan bir sürece bağlanın

Daha önce eklediğiniz bir işleme hızla yeniden bağlanmak için bkz. İşleme yeniden ekleme.

Visual Studio 2022 sürüm 17.10 Preview 2'den başlayarak İşleme Ekle iletişim kutusu değişti. Eski iletişim kutusuyla eşleşen yönergelere ihtiyacınız varsa Visual Studio 2019 görünümüne geçin (makalede sol üst sürüm seçicisi).

Yerel bilgisayarınızdaki bir işleme eklemek için:

1. Visual Studio'da Hata Ayıkla>İşleme Ekle'yi seçin (veya Ctrl+Alt+P tuşlarına basarak) İşleme Ekle iletişim kutusunu açın.

2. Bağlantı türünüYerel olarak ayarlayın.

   Çoğu yerel hata ayıklama senaryosunda Yerel'i kullanabilirsiniz. Bazı senaryolar farklı bir bağlantı türü gerektirebilir. Daha fazla bilgi için bu makaledeki diğer bölümlere veya Yaygın hata ayıklama senaryolarına bakın.

   

3. Kullanılabilir işlemler listesinde, eklemek istediğiniz işlemi veya işlemleri bulun ve seçin.

   • Bir işlemi hızlı bir şekilde seçmek için, İşlemleri filtrele kutusuna adını veya ilk harfini yazın.
   • İşlem adını bilmiyorsanız listeye göz atın veya bazı yaygın işlem adları için yaygın hata ayıklama senaryolarına bakın.
   • Bilgisayarınızda işlemi ayarlayan bir pencere seçmeyi etkinleştirmek için Pencereyi İzle düğmesini kullanın.

   İpucu

   İşleme Ekle iletişim kutusu açıkken işlemler arka planda başlayıp durabilir, bu nedenle çalışan işlemler listesi her zaman güncel olmayabilir. Geçerli listeyi görmek için istediğiniz zaman Yenile'yi seçebilirsiniz.

4. Kod türü alanında, hata ayıklamayı planladığınız kod türünün listelendiğinden emin olun.

   Varsayılan Otomatik ayar çoğu uygulama türünde çalışır, ancak hata ayıklayıcı türünü el ile belirtmek için belirli bir kod türünü seçebilirsiniz.

5. İliştir'i seçin.

İpucu

Birden çok özdeş işleminiz olduğu senaryoda, doğru işlemi tanımlamak için Komut Satırı sütununu veya Başlık sütunundaki w3wp işlemi ayrıntılarını kullanın.

Uyarı

Hata ayıklama için birden çok uygulamaya eklenebilirsiniz, ancak hata ayıklayıcıda aynı anda yalnızca bir uygulama etkindir. Etkin uygulamayı Visual Studio Hata Ayıklama Konumu araç çubuğunda veya İşlemler penceresinde ayarlayabilirsiniz.

Uzak bilgisayardaki bir işleme bağlan

Ayrıca, İşleme Ekle iletişim kutusunda bir uzak bilgisayar seçebilir, bu bilgisayarda çalışan kullanılabilir işlemlerin listesini görüntüleyebilir ve hata ayıklama için bir veya daha fazla işleme ekleyebilirsiniz. Uzak bilgisayarda uzak hata ayıklayıcı (msvsmon.exe) çalışıyor olmalıdır. Daha fazla bilgi için bkz. Uzaktan hata ayıklama.

Visual Studio 2022 sürüm 17.10 Preview 2'den başlayarak İşleme Ekle iletişim kutusu değişti. Eski iletişim kutusuyla eşleşen yönergelere ihtiyacınız varsa Visual Studio 2019 görünümüne geçin (makalede sol üst sürüm seçicisi).

Uzak bilgisayarda çalışan bir işleme eklemek için:

1. Visual Studio'da Hata Ayıkla>İşleme Ekle seçeneğini belirleyin (veya Ctrl+Alt+P tuşlarına basarak) İşleme Ekle iletişim kutusunu açın.

2. Bağlantı türünüUzak (Windows) gibi bir uzak bağlantı türüne ayarlayın.

   Windows'ta uzaktan hata ayıklama senaryolarının çoğunda Uzak (Windows) kullanabilirsiniz. Linux veya kapsayıcılı uygulamada hata ayıklama gibi bazı senaryolar farklı bir bağlantı türü gerektirir. Daha fazla bilgi için bu makaledeki diğer bölümlere veya Yaygın hata ayıklama senaryolarına bakın.

   Bağlantı hedefi seçeneği görüntülenir.

3. Bağlantı hedefi kutusunda, aşağıdaki yöntemlerden birini kullanarak uzak bilgisayarı seçin:

   • Bağlantı hedefi'nin yanındaki açılan liste okunu seçin ve açılan listeden bilgisayar adını seçin.
   • Bağlantı hedefi kutusuna bilgisayar adını yazın ve Enter tuşuna basın.
   • Uzak Bağlantılar iletişim kutusunu açmak için Bağlantı hedefi kutusunun yanındaki Bul düğmesini seçin. Uzak Bağlantılar iletişim kutusu, yerel alt ağınızdaki veya doğrudan bilgisayarınıza bağlı tüm cihazları listeler. Uzak cihazları bulmak için sunucuda giden UDP bağlantı noktası 3702'yi açmanız gerekebilir. İstediğiniz bilgisayarı veya cihazı seçin ve iletişim kutusunu kapatın.

   Visual Studio'nun gerekli bağlantı noktasını bilgisayar adına eklediğini doğrulayın; bu bağlantı noktası şu biçimde görünür: <uzak bilgisayar adı>:p ort

   Uyarı

   Uzak bilgisayar adını kullanarak bağlanamıyorsanız, IP ve bağlantı noktası adresini (örneğin, 123.45.678.9:4026) kullanmayı deneyin. 4026, Visual Studio 2022 uzaktan hata ayıklayıcısı için varsayılan bağlantı noktasıdır. Diğer uzak hata ayıklayıcısı bağlantı noktası atamaları için bkz. Uzak hata ayıklayıcı bağlantı noktası atamaları.

   Bağlantı türü ayarı hata ayıklama oturumları arasında kalır. Bağlantı hedefi ayarı yalnızca bu hedefle başarılı bir hata ayıklama bağlantısı oluştuğunda hata ayıklama oturumları arasında kalır.

4. Kullanılabilir işlemler listesini doldurmak için Yenile'ye tıklayın.

   İpucu

   İşleme Ekle iletişim kutusu açıkken işlemler arka planda başlayıp durabilir, bu nedenle çalışan işlemler listesi her zaman güncel olmayabilir. Geçerli listeyi görmek için istediğiniz zaman Yenile'yi seçebilirsiniz.

5. Kullanılabilir işlemler listesinde, eklemek istediğiniz işlemi veya işlemleri bulun ve seçin.

   • Bir işlemi hızlı bir şekilde seçmek için işlem arama kutusuna adını veya ilk harfini yazın.

   • İşlem adını bilmiyorsanız listeye göz atın veya bazı yaygın işlem adları için yaygın hata ayıklama senaryolarına bakın.

   • Tüm kullanıcı hesapları altında çalışan işlemleri bulmak için Tüm kullanıcılardan işlemleri göster onay kutusunu seçin.

     Uyarı

     Güvenilmeyen bir kullanıcı hesabına ait bir işleme eklemeye çalışırsanız, bir güvenlik uyarısı iletişim kutusu onayı görüntülenir. Daha fazla bilgi için bkz . Güvenlik Uyarısı: Güvenilmeyen bir kullanıcının sahip olduğu işleme ekleme tehlikeli olabilir. Aşağıdaki bilgiler şüpheli görünüyorsa veya emin değilseniz bu işleme eklemeyin.

6. Kod türü alanında, hata ayıklamayı planladığınız kod türünün listelendiğinden emin olun.

   Varsayılan Otomatik ayar çoğu uygulama türünde çalışır, ancak hata ayıklayıcı türünü el ile belirtmek için belirli bir kod türünü seçebilirsiniz.

7. İliştir'i seçin.

Uyarı

Hata ayıklama için birden çok uygulamaya eklenebilirsiniz, ancak hata ayıklayıcıda aynı anda yalnızca bir uygulama etkindir. Etkin uygulamayı Visual Studio Hata Ayıklama Konumu araç çubuğunda veya İşlemler penceresinde ayarlayabilirsiniz.

Bazı durumlarda, Uzak Masaüstü (Terminal Hizmetleri) oturumunda hata ayıkladığınızda , Kullanılabilir işlemler listesi tüm kullanılabilir işlemleri görüntülemez. Visual Studio'yu sınırlı kullanıcı hesabı olan bir kullanıcı olarak çalıştırıyorsanız , Kullanılabilir işlemler listesi Oturum 0'da çalışan işlemleri göstermez. Oturum 0, w3wp.exedahil olmak üzere hizmetler ve diğer sunucu işlemleri için kullanılır. Visual Studio'yu bir yönetici hesabı altında çalıştırarak veya Uzak Masaüstü oturumu yerine sunucu konsolundan Visual Studio'yu çalıştırarak sorunu çözebilirsiniz.

Bu geçici çözümlerden hiçbiri mümkün değilse, Üçüncü bir seçenek Windows komut satırından çalıştırarak vsjitdebugger.exe -p <ProcessId> işleme eklemektir. tlist.exekullanarak işlem kimliğini belirleyebilirsiniz. tlist.exe dosyasını elde etmek için, WDK ve WinDbg indirmelerinde mevcut olan Windows için Hata Ayıklama Araçları'nı indirerek yükleyin.

Azure App Service'te (Windows) çalışan bir .NET Core işlemine ekleme

Azure App Service'te (Windows) yayımlıyorsanız yönergeler için bkz. Azure'da Çekirdek ASP.NET uzaktan hata ayıklama veya Azure App Service'te Hata Ayıklama .

SSH kullanarak Linux üzerinde çalışan bir .NET Core işlemine ekleme

Daha fazla bilgi için bkz. SSH kullanarak Linux üzerinde çalışan .NET Core'da uzaktan hata ayıklama.

Docker konteynerinde çalışan bir işleme bağlanmak

Visual Studio 2019'dan başlayarak, Visual Studio hata ayıklayıcısını Docker kapsayıcısında çalışan bir işleme ekleyebilirsiniz. Linux .NET Core Docker kapsayıcısı için bkz. Linux Docker kapsayıcısı üzerinde çalışan işleme ekleme. Windows Docker kapsayıcısı için bkz. Windows Docker kapsayıcısı üzerinde çalışan işleme ekleme.

Bir işleme yeniden bağlanma

Daha önce bağlı olduğunuz işlemlere hızla yeniden bağlanmak için Hata Ayıkla>İşleme Yeniden Bağlan (Shift+Alt+P) seçeneğini kullanabilirsiniz. Bu komutu seçtiğinizde, hata ayıklayıcı, önce önceki işlem kimliğiyle eşleşip eşleşmediğini kontrol ederek, bu başarısız olursa önceki işlem adıyla eşleşip eşleşmediğini kontrol ederek, daha önce bağlandığınız son işlemlere hemen bağlanmaya çalışır. Eşleşme bulunmazsa veya aynı ada sahip birkaç işlem varsa, doğru işlemi seçebilmeniz için İşleme Ekle iletişim kutusu açılır.

Uyarı

İşleme Yeniden Ekle komutu Visual Studio 2017'den itibaren kullanılabilir.

Yaygın hata ayıklama senaryoları

İşleme Ekle'yi kullanıp kullanmayabileceğinizi ve hangi işleme ekleneceğini belirlemenize yardımcı olmak için aşağıdaki tabloda, kullanılabilir durumda daha fazla yönergenin bağlantılarını içeren birkaç yaygın hata ayıklama senaryosu gösterilmektedir. (Liste kapsamlı değil.)

Eklenecek çalışan bir işlemi hızla seçmek için Visual Studio'da Ctrl+Alt+P yazın ve ardından işlem adının ilk harfini yazın.

Hata ayıklayıcının C++ dilinde yazılmış koda bağlanabilmesi için kodun DebuggableAttribute yayması gerekir. /ASSEMBLYDEBUG bağlayıcı seçeneğiyle bağlantı ekleyerek bunu kodunuza otomatik olarak ekleyebilirsiniz.

İstemci tarafında betik hata ayıklaması için, tarayıcıda betik hata ayıklaması etkinleştirilmelidir. Chrome'da istemci tarafı betiğinde hata ayıklamak için kod türü olarak JavaScript veya TypeScript'i seçin ve uygulama türünüza bağlı olarak tüm Chrome örneklerini kapatmanız ve tarayıcıyı hata ayıklama modunda başlatmanız gerekebilir (komut satırından yazın chrome.exe --remote-debugging-port=9222 ).

Scenario	Hata ayıklama yöntemi	İşlem adı	Notlar ve bağlantılar
ASP.NET Core - Internet Information Services (IIS) sunucusunda uzaktan hata ayıklama	Uzaktan araçları kullanma ve İşleme Bağlan	w3wp.exe veya dotnet.exe	.NET Core 3'den başlayarak ,w3wp.exe işlemi varsayılan uygulama içi barındırma modeli için kullanılır. Uygulama dağıtımı için bkz. IIS'de yayımlama. Daha ayrıntılı bilgi için bkz. Uzak IIS bilgisayarında ASP.NET Core uzaktan hata ayıklama
ASP.NET Core - Uygulamayı hata ayıklayıcı olmadan başlattıktan sonra yerel makinede hata ayıklama	İşleme Ekle'yi kullanma	appname.exe veya iisexpress.exe	Bu, profil oluşturma gibi uygulamanızın daha hızlı yüklenmesini sağlamak için yararlı olabilir. ASP.NET Core için varsayılan yerel sunucu (kestrel) işlemi appname.exe.
ASP.NET 4 veya 4.5 - IIS sunucusunda uzaktan hata ayıklama	Uzak araçları kullan ve İşleme Bağlan	w3wp.exe	Bkz. Uzak IIS bilgisayarında uzaktan hata ayıklama ASP.NET
İstemci tarafı betiği - Desteklenen uygulama türleri için yerel IIS sunucusunda hata ayıklama	İşleme Ekle özelliğini kullan	chrome.exe veya msedge.exe	Betik hata ayıklama etkinleştirilmelidir. Chrome için, Chrome'u hata ayıklama modunda da çalıştırmanız (komut satırından yazınchrome.exe --remote-debugging-port=9222) ve Ekle alanında JavaScript veya TypeScript'i seçmeniz gerekir.
C#, Visual Basic veya C++ uygulaması - Yerel makinede hata ayıklama	Standart hata ayıklama (F5) veya İşleme Ekle'yi kullanın	{appname}.exe	Çoğu senaryoda standart hata ayıklamayı kullanın ve İşleme Bağlan'ı tercih etmeyin.
Windows masaüstü uygulaması - Uzaktan hata ayıklama	Uzak araçlar	Mevcut Değil	Bkz . C# veya Visual Basic uygulamasındauzaktan hata ayıklama veya C++ uygulamasında uzaktan hata ayıklama
Linux üzerinde .NET Core - Hata Ayıklama	İşleme Ekle'yi kullanma	dotnet.exe veya benzersiz bir işlem adı	SSH kullanmak için bkz. SSH kullanarak Linux üzerinde çalışan .NET Core'da uzaktan hata ayıklama. Kapsayıcılı uygulamalar için bkz. Docker kapsayıcısında çalışan işleme ekleme.
Kapsamlanmış uygulama - Hata ayıklama	İşleme Ekle'yi kullanma	dotnet.exe veya benzersiz bir işlem adı	Bkz. Docker kapsayıcısında çalışan işleme ekleme
Linux üzerinde Python - Uzaktan hata ayıklama	İşleme Ekle'yi kullanın	debugpy	Bkz . Python Araçları'ndan uzaktan ekleme
Desteklenen diğer uygulama türleri - Sunucu işleminde hata ayıklama	Sunucu uzaksa, uzak araçları kullanın ve İşleme Bağlan seçeneğini kullanın.	chrome.exe, msedge.exe veya diğer işlemler	Gerekirse, işlemi tanımlamaya yardımcı olması için Kaynak İzleyicisi'ni kullanın. Bkz. Uzaktan hata ayıklama.
Evrensel Windows Platformu (UWP) Uygulaması, OneCore, HoloLens veya IoT uygulaması - Uzaktan hata ayıklama	Yüklü uygulama paketinde hata ayıklama	Mevcut Değil	bkz. İşleme Ekle'yi kullanmak yerine yüklü bir uygulama paketinde hata ayıklama
UWP Uygulaması, OneCore, HoloLens veya IoT - Visual Studio'dan başlatmadığınız bir uygulamada hata ayıklama	Yüklü uygulama paketinde hata ayıklama	Mevcut Değil	bkz. İşleme Ekle'yi kullanmak yerine yüklü bir uygulama paketinde hata ayıklama

Hata ayıklayıcı özelliklerini kullanma

Bir işleme eklerken Visual Studio hata ayıklayıcısının tüm özelliklerini (kesme noktalarına basma gibi) kullanmak için uygulamanın yerel kaynağınızla ve sembollerinizle tam olarak eşleşmesi gerekir. Yani, hata ayıklayıcının doğru sembol (.pdb) dosyalarını yükleyebilmesi gerekir. Varsayılan olarak, bu bir hata ayıklama derlemesi gerektirir.

Uzaktan hata ayıklama senaryoları için, kaynak kodun (veya kaynak kodun bir kopyasının) Visual Studio'da zaten açık olması gerekir. Uzak makinedeki derlenmiş uygulama ikili dosyaları, yerel makinedekiyle aynı derlemeden gelmelidir.

Bazı yerel hata ayıklama senaryolarında, uygulamada doğru sembol dosyaları varsa kaynağa erişimi olmayan Visual Studio'da hata ayıklayabilirsiniz. Varsayılan olarak, bu bir hata ayıklama derlemesi gerektirir. Daha fazla bilgi için bkz. Simge ve kaynak dosyaları belirtme.

Bağlantı hatalarını giderme

Bazı senaryolarda hata ayıklayıcının hata ayıklanacak kod türünü doğru şekilde tanımlaması için yardıma ihtiyacı olabilir. Bağlantı değerleri doğru ayarlanmışsa ( Kullanılabilir işlemler listesinde doğru işlemi görüntüleyebilirsiniz), ancak hata ayıklayıcı eklenemiyorsa, Kod türü listesinde en uygun hata ayıklayıcıyı seçmeyi deneyin; örneğin, bir Linux veya Python uygulamasında hata ayıklarken bu gerekli olabilir.

Bazen hata ayıklayıcı bir kod türüne eklenmeyi başarabilir, ancak başka bir kod türüne eklenemez. Bu durum genellikle aşağıdaki durumlarda oluşur:

• Uzak bir bilgisayarda çalışan bir sürece bağlanmaya çalışıyorsunuz. Uzak bilgisayarda bazı kod türleri için uzaktan hata ayıklama bileşenleri yüklü olabilir, ancak diğerleri için yüklü olmayabilir.
• Doğrudan veritabanı hata ayıklaması için iki veya daha fazla işleme bağlanmaya çalışırsınız. SQL hata ayıklama yalnızca tek bir işleme eklemeyi destekler.

Hata ayıklayıcı bazı kod türlerine bağlanabiliyor ancak tümüne bağlanamıyorsa, hangi türlerin bağlanamadığını belirten bir mesaj görürsünüz.

Hata ayıklayıcı en az bir kod türüne başarıyla bağlanırsa, işlemi hata ayıklamaya devam edebilirsiniz. Yalnızca başarıyla eklenmiş kod türlerinin hatalarını ayıklayabileceksiniz. İşlemdeki eklenmemiş kod çalışmaya devam eder, ancak kesme noktaları ayarlayamaz, verileri görüntüleyemez veya bu kod üzerinde başka hata ayıklama işlemleri gerçekleştiremezsiniz.

Hata ayıklayıcının neden bir kod türüne eklenemediği hakkında daha ayrıntılı bilgi istiyorsanız, yalnızca bu kod türüne yeniden eklemeyi deneyin.

Bir kod türünün neden eklenemediği hakkında belirli bilgileri alma

1. İşlemden ayrılın. Hata Ayıklama menüsünde Tüm Bağlantıları Kes seçeneğini seçin.

2. yalnızca eklenemeyen kod türünü seçerek işleme yeniden bağlanın.

   1. İşleme Ekle iletişim kutusunda Kullanılabilir işlemler listesinden işlemi seçin.

   2. Kod türü seçeneğinde eklenemeyen kod türünü seçin. Diğer kod türlerinin seçimini kaldırın.

   3. İşleme Ekle iletişim kutusunda Ekle'yi seçin.

   Bu kez ekleme işlemi tamamen başarısız olur ve belirli bir hata iletisi alırsınız.

İlgili içerik

• Birden çok işlemde hata ayıklama
• SadeceIn-Time ile hata ayıklama
• uzaktan hata ayıklama