DkmEngineSettings Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Dziedziczenie
- Atrybuty
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) |