DkmRootVisualizedExpression.Create Methode

Definition

Überlädt

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.

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

Erstellen Sie eine neue dkmrootvisualizedexpression-Objektinstanz.

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpression ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, Microsoft::VisualStudio::Debugger::Evaluation::DkmExpressionValueHome ^ ValueHome, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, System::String ^ Name, System::String ^ FullName, Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpressionFlags Flags, System::UInt32 ArrayLength, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpression Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome ValueHome, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, string Name, string FullName, Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags Flags, uint ArrayLength, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Guid * Guid * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * string * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags * uint32 * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpression
Public Shared Function Create (InspectionContext As DkmInspectionContext, VisualizerId As Guid, SourceId As Guid, StackFrame As DkmStackWalkFrame, ValueHome As DkmExpressionValueHome, Module As DkmModule, Name As String, FullName As String, Flags As DkmRootVisualizedExpressionFlags, ArrayLength As UInteger, DataItem As DkmDataItem) As DkmRootVisualizedExpression

Parameter

InspectionContext
DkmInspectionContext

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

VisualizerId
Guid

In 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.

SourceId
Guid

In 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.

StackFrame
DkmStackWalkFrame

In Stapel Rahmen, in dem der Ausdruck ausgewertet wird.

ValueHome
DkmExpressionValueHome

[In, optional] 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.

Module
DkmModule

[In, optional] Das Modul, das das Typsymbol enthält.

Name
String

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

FullName
String

In 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.

Flags
DkmRootVisualizedExpressionFlags

In 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.

ArrayLength
UInt32

In Veraltet: wird nicht mehr verwendet.

DataItem
DkmDataItem

[In, optional] Das Datenobjekt, das der neuen dkmrootvisualizedexpression-Instanz hinzugefügt werden soll. Übergeben Sie "Null", wenn der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmRootVisualizedExpression

Vorgenommen Ergebnis dieses Methoden Aufrufes.

Gilt für

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.
public:
 static Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpression ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, Microsoft::VisualStudio::Debugger::Evaluation::DkmExpressionValueHome ^ ValueHome, Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Module, System::String ^ Name, System::String ^ FullName, Microsoft::VisualStudio::Debugger::Evaluation::DkmRootVisualizedExpressionFlags Flags, System::UInt32 ArrayLength, System::String ^ Type, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpression Create (Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Guid VisualizerId, Guid SourceId, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome ValueHome, Microsoft.VisualStudio.Debugger.Symbols.DkmModule Module, string Name, string FullName, Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags Flags, uint ArrayLength, string Type, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Guid * Guid * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmExpressionValueHome * Microsoft.VisualStudio.Debugger.Symbols.DkmModule * string * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpressionFlags * uint32 * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.DkmRootVisualizedExpression
Public Shared Function Create (InspectionContext As DkmInspectionContext, VisualizerId As Guid, SourceId As Guid, StackFrame As DkmStackWalkFrame, ValueHome As DkmExpressionValueHome, Module As DkmModule, Name As String, FullName As String, Flags As DkmRootVisualizedExpressionFlags, ArrayLength As UInteger, Type As String, DataItem As DkmDataItem) As DkmRootVisualizedExpression

Parameter

InspectionContext
DkmInspectionContext

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

VisualizerId
Guid

In 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.

SourceId
Guid

In 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.

StackFrame
DkmStackWalkFrame

In Stapel Rahmen, in dem der Ausdruck ausgewertet wird.

ValueHome
DkmExpressionValueHome

[In, optional] 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.

Module
DkmModule

[In, optional] Das Modul, das das Typsymbol enthält.

Name
String

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

FullName
String

In 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.

Flags
DkmRootVisualizedExpressionFlags

In 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.

ArrayLength
UInt32

In Veraltet: wird nicht mehr verwendet.

Type
String

[In, optional] 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.

DataItem
DkmDataItem

[In, optional] Das Datenobjekt, das der neuen dkmrootvisualizedexpression-Instanz hinzugefügt werden soll. Übergeben Sie "Null", wenn der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmRootVisualizedExpression

Vorgenommen Ergebnis dieses Methoden Aufrufes.

Gilt für