DkmRootVisualizedExpression Klasse

Definition

Dispatcher-Objekt, das einen visualisierten Ausdruck der obersten Ebene darstellt. Eine-Instanz wird von der Ausdrucks Auswertung erstellt, wenn Sie festlegt, dass ein Typ visualisiert werden soll.

public ref class DkmRootVisualizedExpression : Microsoft::VisualStudio::Debugger::Evaluation::DkmVisualizedExpression
[System.Runtime.InteropServices.Guid("78ad085c-7b73-5937-a063-e2c7f4ee6556")]
public class DkmRootVisualizedExpression : Microsoft.VisualStudio.Debugger.Evaluation.DkmVisualizedExpression
[<System.Runtime.InteropServices.Guid("78ad085c-7b73-5937-a063-e2c7f4ee6556")>]
type DkmRootVisualizedExpression = class
    inherit DkmVisualizedExpression
Public Class DkmRootVisualizedExpression
Inherits DkmVisualizedExpression
Vererbung
Attribute

Eigenschaften

ArrayLength

Veraltet: wird nicht mehr verwendet.

Flags

Flags, die die Ausdrucks Auswertung an das Schnellansicht-Add-in übergibt, das den fraglichen Wert beschreibt. Dies schließt beispielsweise ein, wenn das Objekt ein Zeiger ist, oder, wenn es sich um einen Verweis handelt.

FullName

Der vollständige Name des Ausdrucks bis zum Stamm Knoten. AddIns können den vollständigen Namen verwenden oder einen eigenen erstellen. Wenn das Add-in jedoch einen anderen vollständigen Namen verwendet, muss es von der Ausdrucks Auswertung analysiert werden.

InspectionContext

Optionen und Ziel Kontext, die beim Durchführen der Überprüfung verwendet werden sollen.

(Geerbt von DkmVisualizedExpression)
InspectionSession

Mithilfe von "inspectionsession" können die verschiedenen Komponenten, die Daten im Ziel Prozess überprüfen, private Daten mit der gleichen Lebensdauer speichern. Inspektionssitzungen werden geschlossen, wenn der Benutzer versucht, den Vorgang fortzusetzen.

(Geerbt von DkmVisualizedExpression)
IsUnloaded

Gibt "true" zurück, wenn ein "entladen"-Ereignis für dieses Objekt ausgelöst wurde (Beispiel: dkmthread:: entladen wird aufgerufen) oder wenn das Objekt geschlossen wurde. Beachten Sie, dass bei der Überprüfung dieses Status, ohne Synchronisierung, der Status "zurückgegeben" möglicherweise nicht mehr genau der Anweisung entspricht, nachdem er gelesen wurde.

(Geerbt von DkmDataContainer)
Module

Optionale Das Modul, das das Typsymbol enthält.

Name

Der Name des Ausdrucks bis zum Stamm Knoten. AddIns können diesen Namen verwenden oder einen eigenen erstellen.

RuntimeInstance

Gibt an, welcher Lauf Zeit Monitor verwendet wird, um diese Auswertung durchzuführen.

(Geerbt von DkmVisualizedExpression)
SourceId

GUID, die die Ausdrucks Auswertung, die dieses Objekt erstellt hat, und das Objekt selbst verknüpft. Wird in der Regel von Ausdrucks auswergratoren verwendet, um Ihre Implementierung von idkmcustomvisualizercallback auf nur dkmvisualizedexpression zu filtern, die Sie erstellt haben.

(Geerbt von DkmVisualizedExpression)
StackFrame

Stapel Rahmen, in dem der Ausdruck ausgewertet wird.

(Geerbt von DkmVisualizedExpression)
TagValue

Dkmvisualizedexpression ist eine abstrakte Basisklasse. Diese Enumeration gibt an, welche abgeleitete Klasse dieses Objekt eine Instanz von ist.

(Geerbt von DkmVisualizedExpression)
Type

Optionale Der Typ des Objekts, das überprüft wird. Dabei handelt es sich häufig um denselben Typ, auf den der natvis-Eintrag verweist, der das Add-in ausgelöst hat. Es kann jedoch auch ein Zeiger oder Verweis auf den Typ oder sogar eine Basisklasse oder eine abgeleitete Klasse des Typs sein. Das Add-in sollte keine Annahmen darüber treffen, was in dieser Zeichenfolge ist, und sollte nicht versuchen, es zu analysieren, um Informationen über das Objekt zu erhalten. Die meisten AddIns sollten diese Zeichenfolge durchlaufen, ebenso wie die "Type"-Eigenschaft des Auswertungs Ergebnisses, das Sie erstellt. Allerdings kann es sein, dass ein Add-in der Zeichenfolge "Type" zusätzliche Anmerkungen hinzufügt, bevor Sie zurückgegeben werden. Diese Zeichenfolge ist für die Visualisierung des-Objekts unerheblich, mit Ausnahme eines Hinweises, was im "Type"-Feld des Ergebnisses abgelegt werden muss. Unabhängig davon, ob das ursprüngliche Objekt ein Zeiger, ein Verweis, ein Basistyp oder ein abgeleiteter Typ ist, identifiziert das angegebene dkmexpressionvaluehome immer den Speicherort des Objekts selbst, nie einen Zeiger oder Verweis auf das Objekt. Hier kann eine leere Typzeichenfolge gegeben werden, wenn der Typ des Auswertungs Ergebnisses nicht für das Szenario wichtig ist, in dem die Schnellansicht aufgerufen wird.

Diese API wurde in Visual Studio 14 RTM (dkmapiversion. VS14RTM) eingeführt.

UniqueId

GUID, die diese Instanz eindeutig identifiziert.

(Geerbt von DkmVisualizedExpression)
ValueHome

Optionale Der Speicherort, an dem der Wert gespeichert wird, der geändert werden kann, um den Wert zu bearbeiten. Dieser Wert sollte für schreibgeschützte Werte NULL sein, z. b. ganzzahlige Konstanten.

(Geerbt von DkmVisualizedExpression)
VisualizerId

GUID, die das Add-in und die Ausdrücke verknüpft, die dieses Add-in aufzurufen. Das Add-in sollte die GUID verwenden, die in der nativen schnell Ansichts Datei als Filter angegeben ist.

(Geerbt von DkmVisualizedExpression)

Methoden

Close()

Schließt eine dkmvisualizedexpression-Objektinstanz. Hierdurch werden alle Ressourcen freigegeben, die mit diesem Objekt für alle Komponenten verknüpft sind. Dies schließt Ressourcen Computer übergreifend oder verwaltete/native Marshalling-Grenzen ein.

Dkmvisualizedexpression-Objekte werden automatisch geschlossen, wenn das zugehörige dkminspectionsession-Objekt geschlossen wird.

(Geerbt von DkmVisualizedExpression)
Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, DkmDataItem)

Erstellen Sie eine neue dkmrootvisualizedexpression-Objektinstanz.

Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, String, DkmDataItem)

Erstellen Sie eine neue dkmrootvisualizedexpression-Objektinstanz.

         Diese API wurde in Visual Studio 14 RTM (dkmapiversion. VS14RTM) eingeführt.
CreateDefaultChildFullName(Int32)

Mit dieser Methode wird ein vollständiger Standardname für einen benutzerdefinierten untergeordneten Ausdruck erstellt. Dieser Name ist der vollständige Name des root-Ausdrucks und eine Erweiterungs Format Zeichenfolge, die bewirkt, dass die Ausdrucks Auswertung einen Rückruf an die Schnellansicht durchführt, um untergeordnete Elemente abzurufen. Die dkmvisualizedexpression-Instanz, für die diese aufgerufen wird, sollte der übergeordnete Visualisierungs Ausdruck für ein untergeordnetes Element und der Visualisierungs Ausdruck für einen Stamm sein.

(Geerbt von DkmVisualizedExpression)
EvaluateExpressionCallback(DkmInspectionContext, DkmLanguageExpression, DkmStackWalkFrame, DkmEvaluationResult)

Diese Methode ermöglicht einem Schnellansicht-Add-in die Verwendung der Ausdrucks Auswertung, um den Standardwert für einen Ausdruck zu kompilieren und auszuwerten. Das Add-in kann dieses Ergebnis unverändert verwenden oder Felder überschreiben, indem ein neues Ergebnis erstellt wird. Das Add-in kann auch die Ausdrucks Auswertung für die Erweiterung mithilfe der Rückrufe "Get Children" verwenden.

(Geerbt von DkmVisualizedExpression)
EvaluateVisualizedExpression(DkmEvaluationResult)

Wertet einen visualisierten Ausdruck aus, der ein dkmevaluationresult zurückgibt.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

(Geerbt von DkmVisualizedExpression)
GetChildren(Int32, DkmInspectionContext, DkmChildVisualizedExpression[], DkmEvaluationResultEnumContext)

Ruft einen enumerationskontext ab, der zum Abrufen der untergeordneten Elemente dieses Auswertungs Ergebnisses verwendet wird. Diese wird in allen Ausdrucks Bewertungs Fenstern verwendet.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

(Geerbt von DkmVisualizedExpression)
GetChildrenCallback(DkmEvaluationResult, Int32, DkmInspectionContext, DkmEvaluationResult[], DkmEvaluationResultEnumContext)

Diese Methode ermöglicht einem Schnellansicht-Add-in die Verwendung der Ausdrucks Auswertung für die Erweiterung. Das Auswertungs Ergebnis, das im visualisierten Ausdruck enthalten ist, muss über evaluateexpressioncallback von der Ausdrucks Auswertung stammen.

(Geerbt von DkmVisualizedExpression)
GetDataItem<T>()

Ruft die Instanz von 't ' ab, die dieser Container Instanz hinzugefügt wurde. Wenn dieser Container kein 't-Zeichen enthält, gibt diese Funktion NULL zurück.

(Geerbt von DkmDataContainer)
GetItems(DkmEvaluationResultEnumContext, Int32, Int32, DkmChildVisualizedExpression[])

Wird aufgerufen, um Elemente aus einer Instanz von dkmevaluationresultenumschlag abzurufen, die durch einen früheren Aufruf von GetChildren erstellt wurde.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

(Geerbt von DkmVisualizedExpression)
GetItemsCallback(DkmEvaluationResultEnumContext, Int32, Int32, DkmEvaluationResult[])

Diese Methode ermöglicht einem Schnellansicht-Add-in die Verwendung der Ausdrucks Auswertung für die Erweiterung mithilfe des bestandenen enumerationskontexts. Diese dient zum Abrufen lokaler Variablen eines Stapel Rahmens oder untergeordneter Elemente aus einem Auswertungs Ergebnis.

(Geerbt von DkmVisualizedExpression)
GetSymbolInterface(Guid, Object)

Ermöglicht benutzerdefinierten Ausdrucks auswerteraddins das Abrufen der Symbol Schnittstelle für den Typ, der visualisiert wird. Dies wird nicht direkt in "dkmvisualizedexpression" gespeichert, um auf dem Remote Computer aktive AddIns zu aktivieren, die nicht von Symbolen abhängen.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

(Geerbt von DkmVisualizedExpression)
GetUnderlyingString()

Diese Methode wird für Auswertungs Ergebnisse verwendet, die dkmevaluationresultflags. rawstring enthalten, um die zugrunde liegende Zeichenfolge ohne einschließende Anführungszeichen oder Escapesequenzen abzurufen. Diese Methode wird aufgerufen, um eine der verschiedenen Zeichen folgen schnell Ansichten in einem Ausdrucks auswertungsfenster anzuzeigen (Klicken Sie auf das Lupensymbol).

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

(Geerbt von DkmVisualizedExpression)
GetUnderlyingStringCallback(DkmEvaluationResult)

Diese Methode wird für Auswertungs Ergebnisse verwendet, die dkmevaluationresultflags. rawstring enthalten, um die zugrunde liegende Zeichenfolge ohne einschließende Anführungszeichen oder Escapesequenzen abzurufen. Diese Methode wird aufgerufen, um eine der verschiedenen Zeichen folgen schnell Ansichten in einem Ausdrucks auswertungsfenster anzuzeigen (Klicken Sie auf das Lupensymbol).

(Geerbt von DkmVisualizedExpression)
RemoveDataItem<T>()

Entfernen Sie die Instanz 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)

Fügen Sie ein neues Element in den Datencontainer ein.

(Geerbt von DkmDataContainer)
SetValueAsString(String, Int32, String)

Ändert den Wert des angegebenen Auswertungs Ergebnisses (nicht schreibgeschützt), damit es mit der angegebenen Zeichenfolge identisch ist. Diese wird verwendet, nachdem der Benutzer einen Wert in einem der Bewertungsfenster bearbeitet hat.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

(Geerbt von DkmVisualizedExpression)
SetValueAsStringCallback(DkmEvaluationResult, String, Int32, String)

Ändert den Wert des angegebenen Auswertungs Ergebnisses (nicht schreibgeschützt), damit es mit der angegebenen Zeichenfolge identisch ist. Diese wird verwendet, nachdem der Benutzer einen Wert in einem der Bewertungsfenster bearbeitet hat.

(Geerbt von DkmVisualizedExpression)
UseDefaultEvaluationBehavior(Boolean, DkmEvaluationResult)

Wird von der Ausdrucks Auswertung aufgerufen, wenn die untergeordneten Elemente eines visualisierten Ausdrucks erweitert werden, der Wert festgelegt wird oder die zugrunde liegende Zeichenfolge abgerufen wird. Wenn das schnell Ansichts-Add-in eine umfassende Kontrolle über den Ausdruck hat, sollte false zurückgegeben werden. Anschließend werden Aufrufe von GetChildren, GetItems, setvalueasstring und getunderlyingstring empfangen. Wenn die Schnellansicht-Add-in diese Vorgänge vollständig auf die Ausdrucks Auswertung zurückschieben möchte, sollte Sie "true" zurückgeben. Außerdem muss die Ausdrucks Auswertung die Instanz von dkmevaluationresult, die von der EE stammen, über eine der idkmcustomvisualizercallback-Methoden zurücklassen. Beachten Sie, dass das Add-in das standardmäßige dkmevaluationresult von der EE abgerufen haben muss, wenn der EE das Objekt Steuern soll. Die Rückgabe von true von dieser Methode wird hauptsächlich von schnell Ansichts-AddIns verwendet, die nur etwas kleiner wie die Ansicht eines Werts optimieren, aber keine Erweiterungs-oder Einstellungs Werte ändern möchten.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

(Geerbt von DkmVisualizedExpression)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose() (Geerbt von DkmVisualizedExpression)

Gilt für