Yalnızca Kodum ile yalnızca kullanıcı kodunda hata ayıklama

Just My Code, sistem, çerçeve ve diğer kullanıcı dışı kodlara yapılan çağrıların üzerinden otomatik olarak geçen bir Visual Studio hata ayıklama özelliğidir. Çağrı Yığını penceresinde, Just My Code bu çağrıları [Dış Kod] çerçevelere daraltıyor.

Yalnızca Kodum .NET ve C++ projelerinde farklı çalışır.

Yalnızca Benim Kodum'un etkinleştirilmesi veya devre dışı bırakılması

Çoğu programlama dili için Just My Code varsayılan olarak etkindir.

• Visual Studio'da Just My Code özelliğini etkinleştirmek veya devre dışı bırakmak için, Araçları>Seçenekleri (veya Hata Ayıklama >Seçenekleri) altında Hata Ayıklama>Genel>, Yalnızca Kodum Etkinleştirseçin veya seçimini kaldırın.

Yalnızca Kodum hata ayıklaması

Hata ayıklama oturumu sırasında Modülleri penceresi, hata ayıklayıcının hangi kod modüllerini Kodum (kullanıcı kodu) olarak ele aldığı ve bunların sembol yükleme durumunu gösterir. Daha fazla bilgi için bkz. Hata ayıklayıcının uygulamanıza nasıl ekli olduğunuhakkında daha fazla bilgi edinin.

Çağrı Yığını veya Görevler penceresinde, Just My Code kullanıcı dışı kodu [External Code]etiketli gri açıklamalı bir kod çerçevesine daraltır.

Daraltılmış bir [Dış Kod] çerçevesindeki kodu görüntülemek için Çağrı Yığını veya Görev penceresinde sağ tıklayın ve bağlam menüsünden Dış Kodu Göster seçeneğini seçin. Genişletilmiş dış kod satırları [Dış Kod ]çerçevesinin yerini alır.

Çağrı Yığını penceresinde genişletilmiş bir dış kod satırına çift tıkladığınızda, kaynak kodda çağıran kod satırı yeşil renkle vurgulanır. Bulunmayan veya yüklenmeyen DLL'ler veya diğer modüller için, bir sembol veya kaynak bulunamadı sayfası açılabilir.

.NET Yalnızca Kodum

.NET projelerinde Just My Code, kullanıcı ve kullanıcı dışı kodları sınıflandırmak için sembol (.pdb) dosyalarını ve program iyileştirmelerini kullanır. .NET hata ayıklayıcısı iyileştirilmiş ikili dosyaları ve yüklenmeyen .pdb dosyalarını kullanıcı dışı kod olarak kabul eder.

Üç derleyici özniteliği, .NET hata ayıklayıcısının kullanıcı kodu olarak kabul etme durumunu da etkiler:

• DebuggerNonUserCodeAttribute, hata ayıklayıcıya uygulandığı kodun kullanıcı kodu olmadığını bildirir.
• DebuggerHiddenAttribute, Just My Code kapalı olsa bile kodu hata ayıklayıcıdan gizler.
• DebuggerStepThroughAttribute, hata ayıklayıcıya kodun içine girmek yerine uygulandığı kodda adım adım ilerleyerek adım atacağını bildirir.

.NET hata ayıklayıcısı diğer tüm kodları kullanıcı kodu olarak kabul eder.

.NET hata ayıklaması sırasında:

• Hata Ayıklama>Kullanıcı dışı kod adımlarında(veya F11) adımında bir sonraki kullanıcı kodu satırına geçin.
• Hata Ayıklama>Kullanıcı dışı kod çalıştırmalarında (veya Shift +F11)bir sonraki kullanıcı kodu satırına geçin.

Başka kullanıcı kodu yoksa, hata ayıklama bitene, başka bir kesme noktasına ulaşana veya hata oluşturana kadar devam eder.

Hata ayıklayıcı kullanıcı dışı kodda durdurulursa (örneğin, Hata Ayıkla>Hepsini Durdur kullanıp kullanıcı dışı kodda duraklarsanız), Kaynak Yok penceresi görüntülenir. Ardından Hata Ayıklama>Adım komutunu kullanarak bir sonraki kullanıcı kodu satırına gidebilirsiniz.

Kullanıcı olmayan kodda işlenmeyen bir özel durum oluşursa, hata ayıklayıcı özel durumun oluşturulduğu kullanıcı kodu satırında sonlandırır.

Özel durum için ilk şans istisnaları etkinleştirilirse, kullanıcı kodunu çağıran satır kaynak kodda yeşil renkle vurgulanır. Çağrı Yığını penceresinde [Dış Kod] etiketli açıklamalı çerçeve görüntülenir.

C++ Yalnızca Kodum

Visual Studio 2017 sürüm 15.8'den itibaren, kod adım adım ilerletme için Kendi Kodlarım da desteklenir. Bu özellik, ayrıca /JMC (Yalnızca kendi kodumun hata ayıklaması) derleyici anahtarının kullanılmasını gerektirir. Anahtar, C++ projelerinde varsayılan olarak etkindir. Just My Code'da Çağrı Yığını penceresi ve çağrı yığını desteği için /JMC anahtarı gerekli değildir.

Kullanıcı kodu olarak sınıflandırılmak için, kullanıcı kodunu içeren ikili dosya için PDB hata ayıklayıcı tarafından yüklenmelidir (yükleme durumunu denetlemek için Modülleri penceresini kullanın).

Çağrı Yığını penceresinde olduğu gibi çağrı yığını davranışı için C++ dilindeki Just My Code işlevi yalnızca bu işlevleri kullanıcı dışı kodkabul eder:

• Sembol dosyasında kaynak bilgileri kaldırılmış olan işlevler.
• Sembol dosyalarının yığın çerçevesine karşılık gelen kaynak dosya olmadığını gösterdiği işlevler.
• belirtilen işlevler, %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers klasöründeki *.natjmc dosyalarında yer alır.

Kod adımlama davranışında, C++ dilinde Yalnızca Kodum yalnızca bu işlevlerin kullanıcı dışı kodolduğunu kabul eder.

• Hata ayıklayıcıya karşılık gelen PDB dosyasının yüklenmediği işlevler.
• belirtilen işlevler, %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers klasöründeki *.natjmc dosyalarında.

C++ hata ayıklaması sırasında kullanıcı dışı kod varsayılan olarak atlanır. C++ hata ayıklaması sırasında:

• Hata Ayıklama>İçine Gir (veya F11) kullanıcı dışı kod adımlarını geçer veya kullanıcı kodunun bir sonraki satırına çalışır, eğer İçine Gir kullanıcı dışı koddan çağrılırsa.
• Hata Ayıklama>Dışına Çık (veya Shift + F11 ile+), kullanıcı dışı kodda bir sonraki kullanıcı kodu satırına (geçerli yığın çerçevesinin dışında) çalışır.

Başka kullanıcı kodu yoksa, hata ayıklama bitene, başka bir kesme noktasına ulaşana veya hata oluşturana kadar devam eder.

Hata ayıklayıcısı kullanıcı dışı kodda bozulursa (örneğin, Hata Ayıklama >Tüm Kesme ve kullanıcı olmayan kodda duraklatmakullanırsanız), adımlama kullanıcı dışı kodda devam eder.

Debugger bir özel durumla karşılaşırsa, kullanıcı veya kullanıcı dışı kodda olsun, özel durumda durur. Kullanıcı tarafından işlenmeyen seçenekler, Özel Durum Ayarları iletişim kutusunda yoksayılır.

C++ çağrı yığınını ve kod adımlama davranışını özelleştirme

C++ projeleri için çağrı yığını penceresinin kullanıcı dışı kod olarak işlediği modülleri, kaynak dosyaları ve işlevleri *.natjmc dosyalarında belirterek belirtebilirsiniz. Bu özelleştirme, en son derleyiciyi kullanıyorsanız kod adımlamaya da uygulanır (bkz. C++ Just My Code).

• Visual Studio makinesinin tüm kullanıcıları için kullanıcı dışı kod belirtmek için .natjmc dosyasını %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers klasörüne ekleyin.
• Tek bir kullanıcının kullanıcı dışı kodunu belirtmek için .natjmc dosyasını %USERPROFILE%\Belgelerim\<Visual Studio sürümü>\Visualizers klasörüne ekleyin.

.natjmc dosyası şu söz dizimine sahip bir XML dosyasıdır:

<?xml version="1.0" encoding="utf-8"?>
<NonUserCode xmlns="http://schemas.microsoft.com/vstudio/debugger/jmc/2015">

  <!-- Modules -->
  <Module Name="ModuleSpec" />
  <Module Name="ModuleSpec" Company="CompanyName" />

  <!-- Files -->
  <File Name="FileSpec"/>

  <!-- Functions -->
  <Function Name="FunctionSpec" />
  <Function Name="FunctionSpec" Module ="ModuleSpec" />
  <Function Name="FunctionSpec" Module ="ModuleSpec" ExceptionImplementation="true" />

</NonUserCode>

Module öğesi öznitelikleri

Dosya öğesi öznitelikleri

İşlev öğesi öznitelikleri

Sadece Benim Kodum ayarlarından bağımsız olarak C++ adımlama davranışını özelleştirme

C++ projelerinde, *.natstepfilter dosyalarında NoStepInto işlevleri olarak listeleyerek devredecek işlevleri belirtebilirsiniz. *.natstepfilter dosyalarında listelenen işlevler Yalnızca Kodum ayarlarına bağımlı değildir. NoStepInto işlevi, hata ayıklayıcıya, bazı StepInto işlevlerini veya diğer kullanıcı kodunu çağırsa bile işlevin üzerine adım atmasını söyler. .natjmc listelenen işlevlerden farklı olarak, hata ayıklayıcı NoStepInto işlevinin içindeki kullanıcı kodunun ilk satırına girer.

• Tüm yerel Visual Studio kullanıcıları için kullanıcı dışı kod belirtmek için .natstepfilter dosyasını %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers klasörüne ekleyin.
• Tek bir kullanıcının kullanıcı dışı kodunu belirtmek için .natstepfilter dosyasını %USERPROFILE%\Belgelerim\<Visual Studio sürümü>\Visualizers klasörüne ekleyin.

.natstepfilter dosyası şu söz dizimine sahip bir XML dosyasıdır:

<?xml version="1.0" encoding="utf-8"?>
<StepFilter xmlns="http://schemas.microsoft.com/vstudio/debugger/natstepfilter/2010">
    <Function>
        <Name>FunctionSpec</Name>
        <Action>StepAction</Action>
    </Function>
    <Function>
        <Name>FunctionSpec</Name>
        <Module>ModuleSpec</Module>
        <Action>StepAction</Action>
    </Function>
</StepFilter>

.natstepfilter ve .natjmc dosyaları hakkında ek bilgi

• Visual Studio 2022 sürüm 17.6'dan başlayarak, .natjmc ve .natstepfilter dosyalarını doğrudan çözüme veya projeye ekleyebilirsiniz.

• .natstepfilter ve .natjmc dosyalarındaki söz dizimi hataları hata ayıklayıcının Çıkış penceresinde bildirilmez.

• .natvis dosyalarının aksine .natstepfilter ve .natjmc dosyaları çalışma sırasında otomatik olarak yeniden yüklenmez. Bunun yerine, bu dosyalar hata ayıklama oturumunun başlangıcına yakın bir yerde yeniden yüklenir.

• Şablon işlevleri için addaki <.*> veya <.* kullanımı yararlı olabilir.

JavaScript Yalnızca Kodum

Visual Studio 2022'deki .esproj projeleri için Visual Studio Code, hata ayıklayıcıyı yapılandırmak ve özelleştirmek için bir launch.json dosyası kullanır. launch.json bir hata ayıklayıcısı yapılandırma dosyasıdır.

Visual Studio, hata ayıklayıcıyı yalnızca kullanıcı koduna ekler. .esproj projeleri için, launch.jsoniçindeki skipFiles ayarını kullanarak Visual Studio'da kullanıcı kodunu (Just My Code ayarları) yapılandırabilirsiniz. Bu ayar, VS Code'daki launch.json ayarlarıyla aynı şekilde çalışır. skipFileshakkında daha fazla bilgi için bkz: İlgisiz Kodu Atlama.