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

Just My Code , sisteme, çerçeveye 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çevelerine 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 Yalnızca Kodum özelliğini etkinleştirmek veya devre dışı bırakmak için, Araçlar>Seçenekleri (veya Hata Ayıklama>Seçenekleri) >Hata Ayıklama>Genel'in altında Yalnızca Kodumu Etkinleştir'i seçin veya seçimini kaldırın.

Yalnızca Kendi Kodumda hata ayıklama

Bir hata ayıklama oturumu sırasında Modüller 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ğu hakkında daha fazla bilgi edinin.

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

Daraltılmış [Dış Kod] çerçevesindeki kodu görüntülemek için Çağrı Yığını veya Görev penceresine sağ tıklayın ve bağlam menüsünden Dış Kodu Göster'i 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ıklanması, kaynak kodda çağıran kod satırını yeşil renkle vurgular. DLL'ler veya bulunmayan veya yüklenmeyen diğer modüller için bir simge 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 Yalnızca Kodum 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:

• Kullanıcı olmayan kod adımlarında, kodun bir sonraki kullanıcı kodu satırına kadar adım adım hatasını ayıklayın>.
• Kullanıcı dışı kodda Hata Ayıklama>Adımı (veya Shift+F11) bir sonraki kullanıcı kodu satırına ç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ünü Kes'i kullanır ve kullanıcı olmayan kodda duraklatırsanız), Kaynak Yok penceresi görüntülenir. Ardından, kullanıcı kodunun sonraki satırına gitmek için Hata Ayıklama>Adımı komutunu kullanabilirsiniz.

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 özel durumları etkinleştirilirse, çağıran kullanıcı kodu satırı kaynak kodda yeşil olarak 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 başlayarak, kod adımlama için Yalnızca Kodum da desteklenir. Bu özellik ayrıca /JMC (Yalnızca kod hata ayıklamam) derleyici anahtarının kullanılmasını gerektirir. Anahtar, C++ projelerinde varsayılan olarak etkindir. Just My Code'daki Ç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ılması için, kullanıcı kodunu içeren ikili dosya için PDB'nin hata ayıklayıcı tarafından yüklenmesi gerekir (yükleme durumunu denetlemek için Modüller 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ışı kod olarak kabul 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.
• %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers klasöründeki *.natjmc dosyalarında belirtilen işlevler.

Kod adımlama davranışı için C++ dilinde Yalnızca Kodum işlevi yalnızca bu işlevleri kullanıcı dışı kod olarak kabul eder:

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

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

• Kullanıcı olmayan koddan Adımla çağrılırsa, kullanıcı dışı kod adımlarında hata ayıklama>(veya F11) kodun üzerinden geçme veya sonraki kullanıcı kodu satırına çalıştırma.
• Kullanıcı dışı kodda Hata Ayıklama>Adımı (veya Shift+F11), 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ı kullanıcı dışı kodda bozulursa (örneğin, Hata Ayıkla Tümünü Ayıkla'yı>kullanır ve kullanıcı olmayan kodda duraklatırsanız), adımlama kullanıcı olmayan kodda devam eder.

Hata ayıklayıcı bir özel duruma isabet ederse, kullanıcı kodunda veya kullanıcı dışı kodda olsun, özel durumda durur. Özel Durum Ayarları iletişim kutusundaki kullanıcı tarafından işlenmeyen seçenekler 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 ele aldığı modülleri, kaynak dosyaları ve işlevleri *.natjmc dosyalarında belirterek belirtebilirsiniz. Bu özelleştirme, en son derleyiciyi kullanıyorsanız kod adımlama için de geçerlidir (bkz. C++ Yalnızca Kodum).

• 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ı için kullanıcı dışı kod belirtmek için .natjmc dosyasını %USERPROFILE%\My Documents\<Visual Studio version>\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>

Modül öğesi öznitelikleri

Dosya öğesi öznitelikleri

İşlev öğesi öznitelikleri

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

C++ projelerinde, *.natstepfilter dosyalarında Bunları 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, bazı StepInto işlevlerini veya diğer kullanıcı kodunu çağırsa bile hata ayıklayıcıya işlevin üzerine adım atıp atmadığını söyler. .natjmc'de listelenen işlevlerden farklı olarak, hata ayıklayıcı NoStepInto işlevinin içindeki kullanıcı kodunun ilk satırına adım atacaktır.

• 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%\My Documents\<Visual Studio version>\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 bildirilir.

• .natvis dosyalarının aksine, .natstepfilter ve .natjmc dosyaları çalışırken 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 veya <.* adının kullanılması <.*> 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.json'daki ayarı kullanarak skipFiles Visual Studio'da kullanıcı kodunu (Yani, Yalnızca Kodum ayarları) yapılandırabilirsiniz. Bu ayar, VS Code'daki launch.json ayarlarıyla aynı şekilde çalışır. skipFiles hakkında daha fazla bilgi için bkz. İlgiSiz Kod Atlama.