DkmEngineSettings Klasa

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Debugger

Zestaw:

Microsoft.VisualStudio.Debugger.Engine.dll

Pakiet:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Zawiera ustawienia debugowania dla całej sesji. Istnieje jedno wystąpienie tego obiektu dla identyfikatora GUID aparatu (np. jedno wystąpienie comPlusOnlyEng2, jedno wystąpienie 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

Dziedziczenie

Object

DkmDataContainer

DkmEngineSettings

Atrybuty

GuidAttribute

Właściwości

AllowOutOfProcessSymbolLoading	W przypadku wartości true debuger załaduje symbole natywne w osobnym procesie. Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
BaseDebugMonitorId	Podstawowy monitor debugowania używany przez ten aparat. Ta wartość może mieć wartość Guid.Empty (GUID_NULL), jeśli aparat może używać różnych podstawowych monitorów debugowania w zależności od debugowanego procesu.
ClrDebuggingServicesId	Wskazuje, która wersja usług debugowania CLR (mscordbi.dll lub inna implementacja interfejsu API ICorDebug) powinna być używana podczas debugowania tego procesu.
DataBreakpointAsString	Jeśli deskryptory punktów przerwania danych powinny być traktowane jako ciągi. Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTM).
DotnetVisualizerExtensionInfos	[Opcjonalnie] Przechowuje odpowiednie informacje o niestandardowych wizualizatorach debugera platformy .NET, które zostały zainstalowane za pośrednictwem pakietów VSIX i są zarządzane przez Menedżera składników rozszerzeń. Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).
EnableAsyncDebugging	Umożliwia przechodzenie przez instrukcje "await" i wyjście z metod asynchronicznych. Ta opcja jest domyślnie włączona.
EnableFuncEvalQuickAbort	Określa, czy funkcja FEQA jest włączona dla tego aparatu dla tej sesji debugowania.
EngineId	Są to wartości IDENTYFIKATOR GUID "standardowego aparatu". Oczekuje się, że ta lista będzie rosnąć wraz z upływem czasu, więc jeśli to możliwe, zaleca się wykonanie zapytania o ustawienie zamiast porównywania EngineId.
Flags	Flagi wskazujące niezmienne cechy tego aparatu.
FuncEvalAbortLoggingLevel	Służy do wskazywania, czy utworzyć zrzut debuggee, gdy eval func zostanie przerwany lub przerwany. Ten interfejs API został wprowadzony w programie Visual Studio 15 Update 4 (DkmApiVersion.VS15Update4).
FuncEvalQuickAbortExcludeList	Lista plików wykonywalnych, dla których funkcja FEQA nie jest włączona, nawet jeśli biblioteki DLL FEQA są ładowane.
ImageDebugDirectoryFormats	Lista obsługiwanych wartości dla IMAGE_DEBUG_DIRECTORY. Typu.
IsAutomaticDecompilationEnabled	Jeśli to prawda, moduły mogą być automatycznie dekompilowane, gdy informacje o symbolach są niedostępne z innych źródeł. Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).
IsEditAndContinue	Włącza opcję Edytuj i kontynuuj. Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
IsFastEvaluateAllowed	Jeśli wartość true (stan domyślny), inspektor CLR podejmie próbę zinterpretowania prostych właściwości/metod w niektórych przypadkach zamiast używania func-eval. Bardziej skomplikowane metody będą nadal oceniane przy użyciu func-eval. Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2).
IsGpuRaceHazardsAllowSameSettingEnabled	Jeśli to prawda, debuger zignoruje zagrożenia wyścigowe procesora GPU, które nie zmieniły poprzednich danych.
IsJustMyCodeEnabled	Jeśli to prawda, debuger włączy funkcje JustMyCode (wykonywanie kroków, stos wywołań i filtrowanie wyjątków).
IsNativeExportsEnabled	W przypadku wartości true debuger podejmie próbę użycia tabel eksportu z plików Win32 PE w celu rozpoznania adresów.
IsNativeJustMyCodeSteppingEnabled	Jeśli to prawda, debuger włączy krok po kroku Just My Code dla natywnego (gdy moduł jest kompilowany za pomocą przełącznika /JMC). Ten interfejs API został wprowadzony w programie Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8).
IsStepOverPropertiesAndOperatorsEnabled	W przypadku wartości true debuger przejdzie przez właściwości i operatory po wykonaniu kroku.
IsSuppressOptimizationsEnabled	Jeśli to prawda, debuger pominie optymalizacje kompilatora just in time dla nowo załadowanych modułów.
IsUnloaded	Zwraca wartość true, jeśli dla tego obiektu zostało podniesione zdarzenie "unloaded" (na przykład: DkmThread::Unload jest wywoływane) lub jeśli obiekt został zamknięty. Należy pamiętać, że podczas sprawdzania tego stanu należy zachować ostrożność, ponieważ bez synchronizacji zwrócony stan może nie być już dokładny po odczytaniu instrukcji. (Odziedziczone po DkmDataContainer)
Languages	Kolekcja wszystkich języków programowania obsługiwanych podczas debugowania tego procesu.
MaxCallStackFrames	Maksymalna liczba ramek obsługiwanych w oknie stosu wywołań. Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
NativeEESettings	[Opcjonalnie] Zawiera ustawienia konfiguracji ewaluatora wyrażeń natywnych. Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7).
RegistryTweaks	[Opcjonalnie] Lista poprawek rejestru w rejestrze programu Visual Studio, których składniki mogą używać do dostosowywania ich zachowania. Dostosowania rejestru są odczytywane z klucza [Katalog główny rejestru programu Visual Studio]\Debugger\EngineSwitches na początku każdej sesji debugowania. Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
RemoteClrPdbNamePatterns	Lista wzorców nazw PDB używanych do określenia, czy plik PDB zostanie załadowany po stronie zdalnej.
RequireFullTrustForSourceServer	Jeśli to prawda, debuger będzie wymagał, aby zestawy byłyby w pełni zaufane przed wykonaniem poleceń serwera źródłowego z zestawu. Koncepcja w pełni zaufanego dotyczy tylko zestawów CLR.
SymbolPaths	Kolekcja ciągów DkmString reprezentujących ścieżki wyszukiwania symboli i ścieżkę pamięci podręcznej.
TraceSettings	[Opcjonalnie] Ustawienia śledzenia dla danych wyjściowych WPF. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ValidateFilesForMinidumps	Prawda, jeśli debuger powinien zweryfikować podpisy cyfrowe bibliotek debugowania CLR przed ich załadowaniem. Należy pamiętać, że pomimo nazwy to ustawienie jest faktycznie używane dla wszystkich typów debugowania. Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Metody

FindProcess(Guid)	Znajdź element DkmProcess w ramach tego elementu DkmEngineSettings. Jeśli nie ma żadnego elementu z danym kluczem wejściowym, funkcja FindProcess zakończy się niepowodzeniem.
FindSettings(Guid)	Znajdź obiekt DkmEngineSettings. Jeśli nie ma żadnego obiektu z danym kluczem wejściowym, funkcja FindSettings zakończy się niepowodzeniem.
GetCodeViewCompilers()	Zwraca wyliczenie wartości DkmCodeViewCompilerId. To wyliczenie może być następnie używane przez dostawcę symboli do mapowania informacji w rekordzie widoku kodu na strukturę DkmCompilerId.
GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>)	Uzyskaj dodatkowe ścieżki środowiska uruchomieniowego clr. Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 1 (DkmApiVersion.VS17Update1).
GetDataItem<T>()	Pobiera wystąpienie elementu "T", które zostało dodane do tego wystąpienia kontenera. Jeśli ten kontener nie zawiera wartości "T", ta funkcja zwróci wartość null. (Odziedziczone po DkmDataContainer)
GetLanguage(DkmCompilerId)	Zwraca obiekt DkmLanguage zgodny z danym identyfikatorem kompilatora. Jeśli język jest nieznany (niezarejestrowany za pomocą aparatu), ta metoda zwróci domyślny obiekt języka.
GetProcesses()	GetProcesses wylicza elementy DkmProcess tego obiektu DkmEngineSettings.
GetSettings()	GetSettings wylicza wszystkie utworzone obiekty DkmEngineSettings.
GetUserDocumentPath()	Pobierz ścieżkę folderu dokumentu użytkownika programu Visual Studio.
RemoveDataItem<T>()	Usuń wystąpienie elementu "T" z tego kontenera. Zwykle wywołanie tej metody jest niepotrzebne, ponieważ kontener danych zostanie automatycznie opróżniony po zamknięciu obiektu. (Odziedziczone po DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)	Umieść nowy element w kontenerze danych. (Odziedziczone po DkmDataContainer)