DkmEngineSettings Klasse

Definition

Namespace:

Microsoft.VisualStudio.Debugger

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Paket:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Enthält die sitzungsweiten Debugeinstellungen. Es gibt eine instance dieses Objekts pro Engine-GUID (z. B. eine instance für COMPlusOnlyEng2, eine instance für 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

Vererbung

Object

DkmDataContainer

DkmEngineSettings

Attribute

GuidAttribute

Eigenschaften

AllowOutOfProcessSymbolLoading	Wenn true, lädt der Debugger native Symbole in einem separaten Prozess. Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) eingeführt.
BaseDebugMonitorId	Basisdebugmonitor, der von dieser Engine verwendet wird. Dieser Wert kann Guid.Empty (GUID_NULL) sein, wenn die Engine je nach dem zu debuggenden Prozess verschiedene Basisdebugmonitore verwenden kann.
ClrDebuggingServicesId	Gibt an, welche Version der CLR-Debugdienste (mscordbi.dll oder eine andere Implementierung der ICorDebug-API) beim Debuggen dieses Prozesses verwendet werden soll.
DataBreakpointAsString	Wenn Datenhaltepunktedeskriptoren als Zeichenfolgen behandelt werden sollen. Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTM) eingeführt.
DotnetVisualizerExtensionInfos	[Optional] Enthält relevante Informationen zu den benutzerdefinierten .NET-Debuggerschnellansichten, die über VSIX-Pakete installiert wurden und vom Erweiterungsteil-Manager verwaltet werden. Diese API wurde in Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) eingeführt.
EnableAsyncDebugging	Ermöglicht das Überspringen von await-Anweisungen und das Überspringen von asynchronen Methoden. Dies ist standardmäßig aktiviert.
EnableFuncEvalQuickAbort	Gibt an, ob FEQA für diese Engine für diese Debugsitzung aktiviert ist.
EngineId	Dies sind die GUID-Werte der Standard-Engine. Es wird erwartet, dass diese Liste im Laufe der Zeit wächst, daher wird empfohlen, nach einer Einstellung abzufragen, anstatt die EngineId zu vergleichen.
Flags	Flags, die unveränderliche Merkmale dieser Engine-Einstellungen angeben.
FuncEvalAbortLoggingLevel	Wird verwendet, um anzugeben, ob ein Speicherabbild der Debuggee erstellt werden soll, wenn ein func eval abgebrochen oder unhöflich abgebrochen wird. Diese API wurde in Visual Studio 15 Update 4 (DkmApiVersion.VS15Update4) eingeführt.
FuncEvalQuickAbortExcludeList	Liste der ausführbaren Dateien, für die FEQA selbst dann nicht aktiviert ist, wenn FEQA-DLLs geladen werden.
ImageDebugDirectoryFormats	Liste der unterstützten Werte für IMAGE_DEBUG_DIRECTORY. Typ.
IsAutomaticDecompilationEnabled	Bei true können Module automatisch dekompiliert werden, wenn Symbolinformationen aus anderen Quellen nicht verfügbar sind. Diese API wurde in Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) eingeführt.
IsEditAndContinue	Aktiviert Bearbeiten und Fortfahren. Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.
IsFastEvaluateAllowed	Bei true (Standardzustand) versucht der CLR-Inspektor in einigen Fällen, einfache Eigenschaften/Methoden zu interpretieren, anstatt func-eval zu verwenden. Kompliziertere Methoden werden weiterhin mit func-eval ausgewertet. Diese API wurde in Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2) eingeführt.
IsGpuRaceHazardsAllowSameSettingEnabled	Wenn true, ignoriert der Debugger GPU-Race-Gefahren, die die vorherigen Daten nicht geändert haben.
IsJustMyCodeEnabled	Wenn true, aktiviert der Debugger JustMyCode-Features (Stepping, Aufrufliste und Ausnahmefilterung).
IsNativeExportsEnabled	Wenn true, versucht der Debugger, die Exporttabellen aus Win32 PE-Dateien zu verwenden, um Adressen aufzulösen.
IsNativeJustMyCodeSteppingEnabled	Wenn true, aktiviert der Debugger das Nur-Mein-Code-Schritt für systemeigene Schritte (wenn das Modul mit dem Schalter /JMC kompiliert wird). Diese API wurde in Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8) eingeführt.
IsStepOverPropertiesAndOperatorsEnabled	Wenn true, übergibt der Debugger Eigenschaften und Operatoren, wenn ein Schritt in abgeschlossen ist.
IsSuppressOptimizationsEnabled	Bei true unterdrückt der Debugger Just-In-Time-Compileroptimierungen für neu geladene Module.
IsUnloaded	Gibt true zurück, wenn ein "unloaded"-Ereignis für dieses Objekt ausgelöst wurde (Beispiel: DkmThread::Unload wird aufgerufen) oder wenn das Objekt geschlossen wurde. Beachten Sie, dass bei der Überprüfung dieses status Vorsicht erforderlich ist, da die zurückgegebene status ohne Synchronisierung die Anweisung nach dem Lesen möglicherweise nicht mehr korrekt ist. (Geerbt von DkmDataContainer)
Languages	Sammlung aller Programmiersprachen, die beim Debuggen dieses Prozesses unterstützt werden.
MaxCallStackFrames	Die maximale Anzahl von Frames, die im Aufruflistefenster unterstützt werden. Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.
NativeEESettings	[Optional] Enthält die Konfigurationseinstellungen für die Systemeigene Ausdrucksauswertung. Diese API wurde in Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) eingeführt.
RegistryTweaks	[Optional] Liste der Registrierungsoptimierungen in der Visual Studio-Registrierung, die Komponenten verwenden können, um ihr Verhalten anzupassen. Registrierungsoptimierungen werden zu Beginn jeder Debugsitzung aus dem Schlüssel [Visual Studio-Registrierungsstamm]\Debugger\EngineSwitches gelesen. Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.
RemoteClrPdbNamePatterns	Liste der PDB-Namensmuster, die verwendet werden, um zu bestimmen, ob PDB auf der Remoteseite geladen wird.
RequireFullTrustForSourceServer	Wenn true, erfordert der Debugger, dass Assemblys vollständig vertrauenswürdig sind, bevor Quellserverbefehle aus einer Assembly ausgeführt werden. Das Konzept der vollständigen Vertrauenswürdigkeit gilt nur für CLR-Assemblys.
SymbolPaths	Eine Auflistung von DkmStrings, die die Suchpfade und den Cachepfad des Symbols darstellt.
TraceSettings	[Optional] Ablaufverfolgungseinstellungen für die WPF-Ausgabe. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
ValidateFilesForMinidumps	True, wenn der Debugger die digitalen Signaturen von CLR-Debugbibliotheken vor dem Laden überprüfen soll. Beachten Sie, dass diese Einstellung trotz des Namens tatsächlich für alle Arten des Debuggens verwendet wird. Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.

Methoden

FindProcess(Guid)	Suchen Sie ein DkmProcess-Element in diesem DkmEngineSettings-Element. Wenn kein Element mit dem angegebenen Eingabeschlüssel vorhanden ist, schlägt FindProcess fehl.
FindSettings(Guid)	Suchen Sie ein DkmEngineSettings-Objekt. Wenn kein Objekt mit dem angegebenen Eingabeschlüssel vorhanden ist, schlägt FindSettings fehl.
GetCodeViewCompilers()	Gibt die Enumeration von DkmCodeViewCompilerId-Werten zurück. Diese Enumeration kann dann von einem Symbolanbieter verwendet werden, um die Informationen in einem Codeansichtsdatensatz der DkmCompilerId-Struktur zuzuordnen.
GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>)	Rufen Sie zusätzliche Clr-Laufzeitpfade ab. Diese API wurde in Visual Studio 17 Update 1 (DkmApiVersion.VS17Update1) eingeführt.
GetDataItem<T>()	Ruft den instance von "T" ab, der diesem Container instance hinzugefügt wurde. Wenn dieser Container kein "T" enthält, gibt diese Funktion NULL zurück. (Geerbt von DkmDataContainer)
GetLanguage(DkmCompilerId)	Gibt das DkmLanguage-Objekt zurück, das der angegebenen Compiler-ID entspricht. Wenn die Sprache unbekannt ist (nicht bei der Engine registriert), gibt diese Methode das Standardsprachobjekt zurück.
GetProcesses()	GetProcesses listet die DkmProcess-Elemente dieses DkmEngineSettings-Objekts auf.
GetSettings()	GetSettings listet alle erstellten DkmEngineSettings-Objekte auf.
GetUserDocumentPath()	Rufen Sie den Visual Studio-Ordnerpfad des Benutzerdokuments ab.
RemoveDataItem<T>()	Entfernen Sie die instance von "T" aus diesem Container. Es ist in der Regel nicht erforderlich, diese Methode aufzurufen, da ein Datencontainer automatisch geleert wird, wenn das Objekt geschlossen wird. (Geerbt von DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)	Platzieren Sie ein neues Element im Datencontainer. (Geerbt von DkmDataContainer)