DkmInspectionContext Klasse

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Evaluation

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Paket:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Optionen und Zielkontext, die beim Ausführen des Überprüfungsvorgangs verwendet werden sollen.

public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
class DkmInspectionContext

[System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")]
public class DkmInspectionContext

[<System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")>]
type DkmInspectionContext = class

Public Class DkmInspectionContext

Vererbung

Object

DkmInspectionContext

Attribute

GuidAttribute

Eigenschaften

AdditionalVisualizationData	[Optional] Gibt eine optionale Liste der vollständigen Pfade an, die visualisierungsdateien verwendet werden sollen, zusätzlich zu den Standarddateien aus dem Benutzerprofilverzeichnis und dem Visual Studio-Installationsverzeichnis. Die Rangfolge zwischen in Konflikt stehenden Visualizern in diesen Pfaden wird relativ zu den Standardpfaden gemäß den in "AdditionalVisualizationDataPriority" angegebenen Informationen aufgelöst. Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.
AdditionalVisualizationDataPriority	Wenn AdditionalVisualizationData angegeben ist, gibt die Priorität dieser Daten relativ zu den Standardsuchspeicherorten an. Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.
EvaluationFlags	Flags, die sich darauf auswirken, wie ein Eingabeausdruck analysiert, kompiliert oder angezeigt werden soll.
FuncEvalFlags	Flags, die sich auf die Ausführung von Funktionsauswertungsanforderungen auswirken.
InspectionSession	Die InspectionSession ermöglicht es den verschiedenen Komponenten, die Daten im Zielprozess untersuchen, private Daten mit derselben Lebensdauer zu speichern. Überprüfungssitzungen werden geschlossen, wenn der Benutzer versucht, den Prozess fortzusetzen.
Language	Sprache, die für die Durchführung von Inspektionen verwendet wird.
Radix	Das Radix, das beim Formatieren ganzzahliger Daten verwendet werden soll. Derzeit werden die Werte "16" und "10" unterstützt.
ReturnValue	[Optional] Veraltet: Nicht verwenden. Stattdessen sollten Komponenten die ReturnValues-Eigenschaft als Liste aller Rückgabewerte verwenden und $ReturnValue festlegen, um das letzte Rückgabewertelement in der Liste darzustellen.
ReturnValues	[Optional] Unformatierte Darstellung von Werten für $ReturnValue 1, $ReturnValue 2 usw. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
RuntimeInstance	Gibt an, welcher Laufzeitmonitor für diese Auswertung verwendet wird.
SymbolsConnection	[Optional] Wenn dies nicht null ist, wird eine Verbindung mit einem Workerprozess angegeben, bei dem Symbole für diesen Überprüfungsvorgang verarbeitet werden. Dies ist NULL, wenn Symbole im IDE-Prozess geladen werden oder wenn sie im Remotedebugger geladen werden (DkmModule.Connection ist nicht NULL). Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) eingeführt.
Thread	Der zu untersuchende Thread.
Timeout	Dies ist das Timeout, das für potenziell langsame Vorgänge wie eine Funktionsauswertung verwendet werden soll. Dieser Wert wird in Millisekunden angegeben.

Methoden

ClrExpressionMayRequireParentheses(String)	Gibt true zurück, wenn der Ausdruck möglicherweise Klammern erfordert, wenn er als Unterausdruck in der Sprache verwendet wird. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue)	Create ein neues DkmInspectionContext-Objekt instance.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority)	Create ein neues DkmInspectionContext-Objekt instance. Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>)	Create ein neues DkmInspectionContext-Objekt instance. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>, DkmWorkerProcessConnection)	Create ein neues DkmInspectionContext-Objekt instance. Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) eingeführt.
EvaluateExpression(DkmWorkList, DkmLanguageExpression, DkmStackWalkFrame, DkmCompletionRoutine<DkmEvaluateExpressionAsyncResult>)	Binden Sie den Eingabeausdruck, und werten Sie ihn aus. Formatieren Sie dann den resultierenden Wert zur Anzeige im Debugger. Dies wird für Datentipps, die watch Fenster, das Direktfenster usw. verwendet. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: IDE-Komponenten können diese Methode aufrufen, unabhängig davon, welcher Codetyp gedebuggt wird. Diese Methode wird derzeit auch für Debugmonitorkomponenten beim Debuggen von Code unterstützt, der unter der CLR ausgeführt wird. diese Funktionalität kann jedoch in einer zukünftigen Version entfernt werden.
EvaluateExpressionOnThreads(DkmWorkList, ReadOnlyCollection<UInt64>, DkmStackWalkFrame, DkmLanguageExpression, DkmCompletionRoutine<DkmEvaluateExpressionOnThreadsAsyncResult>)	Binden Sie den Eingabeausdruck, und werten Sie ihn aus. Formatieren Sie dann den resultierenden Wert zur Anzeige im Debugger. Dies wird für Datentipps, die watch Fenster, das Direktfenster usw. verwendet. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: Die API muss von einer IDE-Komponente aufgerufen werden (Komponentenebene > 100.000).
EvaluateReturnValue(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValue, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult>)	Wertet eine bestimmte DkmRawReturnValue aus und formatiert sie ausschließlich unter Verwendung der bereitgestellten Daten. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: Die API muss von einer IDE-Komponente aufgerufen werden (Komponentenebene > 100.000).
EvaluateReturnValue2(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValueContainer, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult2>)	Wertet eine bestimmte DkmRawReturnValue aus und formatiert sie ausschließlich unter Verwendung der bereitgestellten Daten. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: Die API muss von einer IDE-Komponente aufgerufen werden (Komponentenebene > 100.000). Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
GetClrArrayIndexExpression(String[])	Rufen Sie einen Arrayindexausdruck ab. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrCastExpression(String, DkmClrType, DkmClrCustomTypeInfo, DkmClrCastExpressionOptions)	Rufen Sie einen Castausdruck ab, wenn die Syntax gültig ist. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrExpressionAndFormatSpecifiers(String, ReadOnlyCollection<String>)	Teilt die Zeichenfolge in die Ausdrucks- und Formatbezeichnerteile auf. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrExpressionForNull()	Rufen Sie den sprachspezifischen Ausdruck für NULL (Schlüsselwort (keyword)) ab. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrExpressionForThis()	Rufen Sie den sprachspezifischen Ausdruck für this/Me ab. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrLocalVariableQuery(DkmClrInstructionAddress, Boolean)	Rufen Sie eine DkmCompiledClrLocalsQuery ab, um die Anzeige lokaler Variablen zu ermöglichen. Standorteinschränkung: Die API muss von einer IDE-Komponente aufgerufen werden (Komponentenebene > 100.000). Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
GetClrMemberName(String, DkmClrType, DkmClrCustomTypeInfo, String, Boolean, Boolean)	Rufen Sie einen Memberzugriffsausdruck ab, wenn er als gültige Syntax dargestellt werden kann. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrNameForField(DkmClrModuleInstance, Int32)	Rufen Sie den sprachspezifischen Namen für einen Bezeichner aus Metadaten ab. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) eingeführt.
GetClrNameForLocalVariable(DkmClrModuleInstance, DkmClrMethodId, DkmILRange, DkmClrLocalVariable)	Rufen Sie den sprachspezifischen Namen für einen Bezeichner aus Metadaten ab. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) eingeführt.
GetClrObjectCreationExpression(DkmClrType, DkmClrCustomTypeInfo, String[])	Rufen Sie einen Objekterstellungsausdruck ab, sofern die Syntax gültig ist. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrTypeName(DkmClrType, DkmClrCustomTypeInfo)	Rufen Sie den Typnamen in einer in der Sprache gültigen Form ab, sofern die Syntax gültig ist. Diese Methode dient zum Erstellen gültiger vollständiger Namen mit der Möglichkeit, NULL zu escape/zurückzugeben, wenn keine gültige Syntax vorhanden ist. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetClrValidIdentifier(String)	Rufen Sie den Bezeichner in einer in der Sprache gültigen Form ab. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 15 RTM (DkmApiVersion.VS15RTM) eingeführt.
GetFrameArguments(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameArgumentsAsyncResult>)	Stellt Informationen zu den Argumenten eines Stapelrahmens bereit. Dies wird derzeit nur über das VS-Automatisierungsmodell (EnvDTE.StackFrame.Arguments) verfügbar gemacht. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: IDE-Komponenten können diese Methode aufrufen, unabhängig davon, welcher Codetyp gedebuggt wird. Diese Methode wird derzeit auch für Debugmonitorkomponenten beim Debuggen von Code unterstützt, der unter der CLR ausgeführt wird. diese Funktionalität kann jedoch in einer zukünftigen Version entfernt werden.
GetFrameLocals(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameLocalsAsyncResult>)	Ruft einen Enumerationskontext ab, der zum Abrufen der lokalen Variablen dieses Stapelrahmens verwendet wird. Dies wird beim Berechnen des lokalen Fensters verwendet. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: IDE-Komponenten können diese Methode aufrufen, unabhängig davon, welcher Codetyp gedebuggt wird. Diese Methode wird derzeit auch für Debugmonitorkomponenten beim Debuggen von Code unterstützt, der unter der CLR ausgeführt wird. diese Funktionalität kann jedoch in einer zukünftigen Version entfernt werden.
GetFrameName(DkmWorkList, DkmStackWalkFrame, DkmVariableInfoFlags, DkmCompletionRoutine<DkmGetFrameNameAsyncResult>)	Stellt eine Textdarstellung für einen Stapelrahmen bereit. Dies wird beim Erstellen des formatierten Aufrufstapels verwendet. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: IDE-Komponenten können diese Methode aufrufen, unabhängig davon, welcher Codetyp gedebuggt wird. Diese Methode wird derzeit auch für Debugmonitorkomponenten beim Debuggen von Code unterstützt, der unter der CLR ausgeführt wird. diese Funktionalität kann jedoch in einer zukünftigen Version entfernt werden.
GetFrameReturnType(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameReturnTypeAsyncResult>)	Stellt eine Textdarstellung des Rückgabetyps für einen oder mehrere Stapelrahmen bereit. Dies wird derzeit nur über das VS-Automatisierungsmodell (EnvDTE.StackFrame.ReturnType) verfügbar gemacht. Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist. Standorteinschränkung: Die API muss von einer IDE-Komponente aufgerufen werden (Komponentenebene > 100.000).
GetTypeName(DkmClrType, DkmClrCustomTypeInfo, ReadOnlyCollection<String>)	Ruft die Typnamenzeichenfolge ab, die auf der Benutzeroberfläche für den angegebenen DkmClrType angezeigt werden soll. Diese Methode gibt immer einen Wert zurück und wird in Variablenüberprüfungsfenstern verwendet. Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
WithProperties(UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32)	Erstellt eine Kopie des ursprünglichen DkmInspectionContext mit den aktualisierten bereitgestellten Eigenschaften, z. B. EvaluationFlags oder Radix. Die Eigenschaften sind ein vollständiger Ersatz der Originale und werden nicht mit den ursprünglichen Eigenschaften zusammengeführt. Daher müssen alle gewünschten Eigenschaften aus dem ursprünglichen DkmInspectionContext für diese Methode bereitgestellt werden. Diese API wurde in Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8) eingeführt.