Sdílet prostřednictvím


DkmEngineSettings Třída

Definice

Obsahuje nastavení ladění pro celou relaci. Existuje jedna instance tohoto objektu na identifikátor GUID modulu (příklad: jedna instance pro COMPlusOnlyEng2, jedna instance pro COMPlusNativeEng).

public ref class DkmEngineSettings : Microsoft::VisualStudio::Debugger::DkmDataContainer
[System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")]
public class DkmEngineSettings : Microsoft.VisualStudio.Debugger.DkmDataContainer
[<System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")>]
type DkmEngineSettings = class
    inherit DkmDataContainer
Public Class DkmEngineSettings
Inherits DkmDataContainer
Dědičnost
Dědičnost
DkmEngineSettings
Atributy

Vlastnosti

AllowOutOfProcessSymbolLoading

Pokud je hodnota true, ladicí program načte nativní symboly v samostatném procesu.

Toto rozhraní API bylo představeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).

BaseDebugMonitorId

Základní ladicí monitor používaný tímto modulem. Tato hodnota může být Guid.Empty (GUID_NULL), pokud modul může v závislosti na procesu, který se ladí, používat různé základní monitorování ladění.

ClrDebuggingServicesId

Určuje, která verze služeb ladění CLR (mscordbi.dll nebo jiné implementace rozhraní API ICorDebug) by se měla použít při ladění tohoto procesu.

DataBreakpointAsString

Pokud se zarážky dat mají popisovače považovat za řetězce.

Toto rozhraní API bylo představeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

DotnetVisualizerExtensionInfos

[Volitelné] Obsahuje relevantní informace o vizualizérech vlastního ladicího programu .NET, které byly nainstalovány prostřednictvím balíčků VSIX a které spravuje Správce částí rozšíření.

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).

EnableAsyncDebugging

Umožňuje krokování příkazů await a krokování z asynchronních metod. Ve výchozím nastavení je tato možnost zapnutá.

EnableFuncEvalQuickAbort

Určuje, jestli je pro tento modul povolená funkce FEQA pro tuto ladicí relaci.

EngineId

Jedná se o standardní hodnoty GUID modulu. Očekává se, že se tento seznam časem bude rozšiřovat, takže pokud je to možné, doporučujeme místo porovnání EngineId dotazovat na nastavení.

Flags

Příznaky, které označují neměnné vlastnosti tohoto nastavení modulu.

FuncEvalAbortLoggingLevel

Používá se k označení, jestli se má vytvořit výpis ladicí sady při přerušení nebo hrubém přerušení func eval.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 4 (DkmApiVersion.VS15Update4).

FuncEvalQuickAbortExcludeList

Seznam spustitelných souborů, pro které není povolená funkce FEQA, i když jsou načteny knihovny DLL FEQA.

ImageDebugDirectoryFormats

Seznam podporovaných hodnot pro IMAGE_DEBUG_DIRECTORY Typ.

IsAutomaticDecompilationEnabled

Pokud je hodnota true, moduly mohou být dekompilovány automaticky, pokud informace o symbolu nejsou k dispozici z jiných zdrojů.

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).

IsEditAndContinue

Povolí možnost Upravit a pokračovat.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

IsFastEvaluateAllowed

Při hodnotě true (výchozí stav) se inspektor CLR pokusí v některých případech interpretovat jednoduché vlastnosti/metody místo použití příkazu func-eval. Složitější metody budou stále vyhodnoceny pomocí func-eval.

Toto rozhraní API bylo představeno v sadě Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2).

IsGpuRaceHazardsAllowSameSettingEnabled

Pokud je hodnota true, ladicí program ignoruje nebezpečí závodu GPU, která nezměnila předchozí data.

IsJustMyCodeEnabled

Pokud je hodnota true, ladicí program povolí funkce JustMyCode (krokování, zásobník volání a filtrování výjimek).

IsNativeExportsEnabled

Pokud je hodnota true, ladicí program se pokusí použít tabulky exportu ze souborů Win32 PE k překladu adres.

IsNativeJustMyCodeSteppingEnabled

Pokud je hodnota true, ladicí program povolí krokování jen mého kódu pro nativní (při kompilaci modulu s přepínačem /JMC).

Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8).

IsStepOverPropertiesAndOperatorsEnabled

Pokud je hodnota true, ladicí program krokuje vlastnosti a operátory po dokončení kroku v kroku.

IsSuppressOptimizationsEnabled

Pokud je hodnota true, ladicí program potlačí optimalizace kompilátoru za běhu pro nově načtené moduly.

IsUnloaded

Vrátí hodnotu true, pokud byla pro tento objekt vyvolána událost unloaded (příklad: DkmThread::Unload je volána) nebo pokud byl objekt uzavřen. Mějte na paměti, že při kontrole tohoto stavu je potřeba střídmět, protože bez synchronizace nemusí být vrácený stav po přečtení přesný.

(Zděděno od DkmDataContainer)
Languages

Kolekce všech programovacích jazyků podporovaných při ladění tohoto procesu

MaxCallStackFrames

Maximální počet rámců podporovaných v okně zásobníku volání.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

NativeEESettings

[Volitelné] Obsahuje nastavení konfigurace nativního vyhodnocovače výrazů.

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).

RegistryTweaks

[Volitelné] Seznam vylepšení registru v registru sady Visual Studio, které komponenty mohou použít k přizpůsobení jejich chování. Vylepšení registru se načítají z klíče [Kořen registru sady Visual Studio]\Debugger\EngineSwitches na začátku každé ladicí relace.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

RemoteClrPdbNamePatterns

Seznam vzorů názvů PDB sloužících k určení, jestli se soubor PDB načte na vzdálené straně.

RequireFullTrustForSourceServer

Pokud je hodnota true, ladicí program bude vyžadovat, aby sestavení byla plně důvěryhodná před spuštěním příkazů zdrojového serveru ze sestavení. Koncept plně důvěryhodné se vztahuje pouze na sestavení CLR.

SymbolPaths

Kolekce DkmStrings představující cesty pro vyhledávání symbolů a cestu k mezipaměti.

TraceSettings

[Volitelné] Nastavení trasování pro výstup WPF.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

ValidateFilesForMinidumps

Hodnota True, pokud má ladicí program ověřit digitální podpisy knihoven ladění CLR před jejich načtením. Všimněte si, že bez ohledu na název se toto nastavení ve skutečnosti používá pro všechny typy ladění.

Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Metody

FindProcess(Guid)

Vyhledejte prvek DkmProcess v tomto DkmEngineSettings. Pokud není k dispozici žádný prvek se zadaným vstupním klíčem, FindProcess selže.

FindSettings(Guid)

Vyhledejte objekt DkmEngineSettings. Pokud není k dispozici žádný objekt s daným vstupním klíčem, FindSettings selže.

GetCodeViewCompilers()

Vrátí výčet DkmCodeViewCompilerId hodnot. Tento výčet pak může použít zprostředkovatel symbolů k mapování informací v záznamu zobrazení kódu na strukturu DkmCompilerId.

GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>)

Získejte další cesty modulu runtime CLR.

Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 1 (DkmApiVersion.VS17Update1).

GetDataItem<T>()

Získá instanci T, která byla přidána do této instance kontejneru. Pokud tento kontejner neobsahuje T, vrátí tato funkce hodnotu null.

(Zděděno od DkmDataContainer)
GetLanguage(DkmCompilerId)

Vrátí DkmLanguage objekt, který odpovídá danému ID kompilátoru. Pokud je jazyk neznámý (není zaregistrovaný v modulu), vrátí tato metoda výchozí objekt jazyka.

GetProcesses()

GetProcesses vytvoří výčet prvků DkmProcess tohoto DkmEngineSettings objektu.

GetSettings()

GetSettings vytvoří výčet všech vytvořených objektů DkmEngineSettings.

GetUserDocumentPath()

Získejte cestu ke složce uživatelského dokumentu sady Visual Studio.

RemoveDataItem<T>()

Odeberte z tohoto kontejneru instanci T. Obvykle není nutné volat tuto metodu, protože kontejner dat se při zavření objektu automaticky vyprázdní.

(Zděděno od DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Do kontejneru dat umístěte novou položku.

(Zděděno od DkmDataContainer)

Platí pro