DkmSuccessEvaluationResult Klasse

Definition

Das formatierte Ergebnis einer erfolgreichen Auswertung, das in einem Ausdrucks auswertungsfenster angezeigt werden kann.

public ref class DkmSuccessEvaluationResult : Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResult
[System.Runtime.InteropServices.Guid("5d948996-5805-1795-8b6b-535f0bc32bde")]
public class DkmSuccessEvaluationResult : Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult
[<System.Runtime.InteropServices.Guid("5d948996-5805-1795-8b6b-535f0bc32bde")>]
type DkmSuccessEvaluationResult = class
    inherit DkmEvaluationResult
Public Class DkmSuccessEvaluationResult
Inherits DkmEvaluationResult
Vererbung
Attribute

Eigenschaften

Access

Die Zugriffs Steuerungsebene (Public, private usw.) des Auswertungs Ergebnisses.

Address

Optionale Wenn das Ergebnis eine Adresse ist (d. h. das adressflag wird in Flags festgelegt), wird der Speicherort des Unterstützungs Werts angegeben. Diese wird verwendet, wenn das Auswertungs Ergebnis als Eingabe für das Arbeitsspeicher Fenster oder das Disassemblyfenster verwendet wird. Wenn es sich um eine Anweisungs Adresse handelt, muss die cpuinstruction-Adresse festgelegt sein.

Category

Die Kategorie (z. b. Daten, Methode usw.) dieses Auswertungs Ergebnisses.

CustomUIVisualizers

Optionale Eine Liste von benutzerdefinierten Viewern für dieses Objekt.

EditableValue

Optionale Wenn der Wert beschreibbar ist, gibt die Standard Zeichenfolge an, die verwendet werden soll, wenn Sie auf den Wert doppelklicken, um ihn zu bearbeiten. Der EE sollte in der Lage sein, diese Zeichenfolge zu analysieren und auszuwerten und das aktuelle Auswertungs Ergebnis zu erhalten. Wenn der Wert schreibgeschützt ist, wird der bearbeitbare Wert ignoriert und sollte NULL sein.

ExternalModules

Optionale Falls verfügbar, eine Liste externer Module ohne das aktuelle Modul, die für die Überprüfung des Objekts verwendet werden. Das Laden von Symbolen für so viele Module in dieser Liste wie möglich verbessert die Anzeige des Objekts.

Flags

Flags, die Attribute eines Ausdrucks Auswertungs Ergebnisses angeben.

FullName

Optionale Der vollständige Name des Ausdrucks, für den das Ergebnis gilt. Dieser Wert wird verwendet, um das Hinzufügen untergeordneter Elemente zum Fenster Überwachen zuzulassen (Überwachung über das Kontextmenü hinzufügen) und Teile der Auswertungs Struktur zu aktualisieren. Als Beispiel für die Unterschiede von FullName und Name ist der Name des nullten-Elements eines Arrays in C++ "[0]", während der vollständige Name von "myarrayvariable [0]" ist. Für Visual Studio 14 und höher ist es möglich, bei Bedarf später den vollständigen Namen zu berechnen. Zu diesem Zweck sollte die Ausdrucks Auswertung dkmevaluationresult mit einem vollständigen NULL-Namen erstellen und idkmfullnameprovider implementieren. Von Concord wird dann idkmfullnameprovider. calculatefullname aufgerufen, um bei Bedarf den vollständigen Namen in der Benutzeroberfläche zu erhalten.

(Geerbt von DkmEvaluationResult)
InspectionContext

Der Untersuchungs Kontext, der zum Erstellen dieses Auswertungs Ergebnisses verwendet wird.

(Geerbt von DkmEvaluationResult)
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 DkmEvaluationResult)
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)
Language

Sprache für die Durchführung von Prüfungen.

(Geerbt von DkmEvaluationResult)
Name

Der Name des Ausdrucks, für den das Ergebnis gilt.

(Geerbt von DkmEvaluationResult)
RefreshButtonText

Optionale Gibt den Text an, der als QuickInfo angezeigt wird, wenn der Benutzer auf die Schaltfläche Aktualisieren zeigt, wenn dkmevaluationresultflags:: canevaluatenow festgelegt ist. Wenn dieser Wert NULL ist, wird eine Standardmeldung verwendet.

Diese API wurde in Visual Studio 15 RTM (dkmapiversion. VS15RTM) eingeführt.

RuntimeInstance

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

(Geerbt von DkmEvaluationResult)
StackFrame

Der Stapel Rahmen, in dem dieses Ausdrucks Ergebnis erstellt wurde.

(Geerbt von DkmEvaluationResult)
StorageType

Der Speichertyp (z. b. statisch) des Auswertungs Ergebnisses.

TagValue

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

(Geerbt von DkmEvaluationResult)
Type

Optionale Eine Zeichenfolge, die den Typ des Werts beschreibt.

TypeModifierFlags

Typmodifiziererflags (z.: Konstante) des Auswertungs Ergebnisses.

UniqueId

GUID, die dieses Auswertungs Ergebnis eindeutig identifiziert.

(Geerbt von DkmEvaluationResult)
Value

Optionale Eine Zeichenfolge, die den Wert beschreibt.

Methoden

AddToFavorites(DkmSuccessEvaluationResult)

Fügt der Auflistung der Favoriten Elemente für den Typ dieses Ergebnisses das angegebene untergeordnete Element hinzu.

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

Diese API wurde in Visual Studio 16 Update 4 (dkmapiversion. VS16Update4) eingeführt.

Close()

Schließt das Auswertungs Ergebnis Objekt, um die ihm zugeordneten Ressourcen freizugeben. Diese Methode muss von der Komponente aufgerufen werden, die die Enumeration initiiert hat (z. b. "dkminspectioncontext. EvaluateExpression", "dkmevaluationresultenumcontext. GetItems" usw.).

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

(Geerbt von DkmEvaluationResult)
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, DkmDataItem)

Erstellen Sie eine neue dkmerfolgreisevaluationresult-Objektinstanz.

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, String, DkmDataItem)

Erstellen Sie eine neue dkmerfolgreisevaluationresult-Objektinstanz.

         Diese API wurde in Visual Studio 15 RTM (dkmapiversion. VS15RTM) eingeführt.
CreateDebuggeeSideVisualizerObject(UInt32, String, String, String)

Instanziiert den zu debuggenden benutzerdefinierten Visualisierungstyp im zu debuggenden Prozess.

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

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

CreateObjectId()

Erstellt eine Objekt-ID für diesen speziellen Ausdruck.

Location-Einschränkung: Diese Methode kann von IDE-Komponenten aufgerufen werden, unabhängig davon, welche Art von Code gedebuggt wird. Diese Methode wird derzeit auch für Debug-Monitor Komponenten unterstützt, wenn Sie Code Debuggen, der in der CLR ausgeführt wird. Diese Funktion kann jedoch in einer zukünftigen Version entfernt werden.

(Geerbt von DkmEvaluationResult)
CreateReplacementObjectOnDebuggeeSideVisualizer(Byte[], String, String, String)

Führt die Methode "kreatereplacementobject (...)" der debuggenden Seite des benutzerdefinierten Visualisierungsprogramms aus und schreibt das Ergebnis in das visualisierte Objekt handle.

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

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

DestroyDebuggeeSideVisualizerObject()

Gibt den zu debuggenden benutzerdefinierten Visualisierungstyp im zu debuggenden Prozess frei.

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

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

DestroyObjectId()

Zerstört eine Objekt-ID für diesen speziellen Ausdruck.

Location-Einschränkung: Diese Methode kann von IDE-Komponenten aufgerufen werden, unabhängig davon, welche Art von Code gedebuggt wird. Diese Methode wird derzeit auch für Debug-Monitor Komponenten unterstützt, wenn Sie Code Debuggen, der in der CLR ausgeführt wird. Diese Funktion kann jedoch in einer zukünftigen Version entfernt werden.

(Geerbt von DkmEvaluationResult)
ExtractFromProperty(IDebugProperty3)

Ruft das dkmerfolgreisevaluationresult-Objekt ab, das das IDebugProperty3-Objekt sichert. Diese API funktioniert nur ordnungsgemäß vom Haupt Thread von Visual Studio aus.

GetChildren(DkmWorkList, Int32, DkmInspectionContext, DkmCompletionRoutine<DkmGetChildrenAsyncResult>)

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

Diese Methode fügt ein neues Arbeits Element an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeits Element angefügt wurde. Die tatsächliche Verarbeitung der Arbeitsaufgabe erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Abschluss Routine abgeschlossen wurde.

Location-Einschränkung: Diese Methode kann von IDE-Komponenten aufgerufen werden, unabhängig davon, welche Art von Code gedebuggt wird. Diese Methode wird derzeit auch für Debug-Monitor Komponenten unterstützt, wenn Sie Code Debuggen, der in der CLR ausgeführt wird. Diese Funktion kann jedoch in einer zukünftigen Version entfernt werden.

(Geerbt von DkmEvaluationResult)
GetClrValue()

Ruft den zugrunde liegenden dkmclrvalue aus einem dkmerfolgreisevaluationresult ab, sofern vorhanden.

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

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

GetDataBreakpointDisplayName()

Ruft den anzeigen amen des Daten Breakpoints für das Auswertungs Ergebnis ab.

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

Diese API wurde in Visual Studio 16 RTM (dkmapiversion. VS16RTM) eingeführt.

GetDataBreakpointDisplayName(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointDisplayNameAsyncResult>)

Ruft den anzeigen amen des Daten Breakpoints für das Auswertungs Ergebnis ab.

Diese Methode fügt ein neues Arbeits Element an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeits Element angefügt wurde. Die tatsächliche Verarbeitung der Arbeitsaufgabe erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Abschluss Routine abgeschlossen wurde.

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

Diese API wurde in Visual Studio 16 RTM (dkmapiversion. VS16RTM) eingeführt.

GetDataBreakpointInfo(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointInfoAsyncResult>)

Gibt ggf. die Daten breakpointinformationen zurück, die mit dem Auswertungs Ergebnis verknüpft sind.

Diese Methode fügt ein neues Arbeits Element an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeits Element angefügt wurde. Die tatsächliche Verarbeitung der Arbeitsaufgabe erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Abschluss Routine abgeschlossen wurde.

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

Diese API wurde in Visual Studio 15 Update 8 (dkmapiversion. VS15Update8) eingeführt.

GetDataBreakpointInfo(String)

Gibt ggf. die Daten breakpointinformationen zurück, die mit dem Auswertungs Ergebnis verknüpft sind.

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

Diese API wurde in Visual Studio 15 Update 8 (dkmapiversion. VS15Update8) eingeführt.

GetDataFromDebuggeeSideVisualizer(String, String, String)

Führt die GetData (...)-Methode des benutzerdefinierten Visualisierungsprogramms der debuggenden Seite aus.

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

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

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)
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: Diese Methode kann von IDE-Komponenten aufgerufen werden, unabhängig davon, welche Art von Code gedebuggt wird. Diese Methode wird derzeit auch für Debug-Monitor Komponenten unterstützt, wenn Sie Code Debuggen, der in der CLR ausgeführt wird. Diese Funktion kann jedoch in einer zukünftigen Version entfernt werden.

(Geerbt von DkmEvaluationResult)
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)
RemoveFromFavorites(DkmSuccessEvaluationResult)

Entfernt das angegebene untergeordnete Element aus der Auflistung der bevorzugten Elemente für den Typ dieses Ergebnisses.

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

Diese API wurde in Visual Studio 16 Update 4 (dkmapiversion. VS16Update4) eingeführt.

ResolveAssembly(String, String, ReadOnlyCollection<Byte>)

Löst einen Assemblynamen in den Pfad der Assembly oder in seine unformatierten Bytes auf.

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

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

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: Diese Methode kann von IDE-Komponenten aufgerufen werden, unabhängig davon, welche Art von Code gedebuggt wird. Diese Methode wird derzeit auch für Debug-Monitor Komponenten unterstützt, wenn Sie Code Debuggen, der in der CLR ausgeführt wird. Diese Funktion kann jedoch in einer zukünftigen Version entfernt werden.

(Geerbt von DkmEvaluationResult)
TransferDataToDebuggeeSideVisualizer(Byte[], String, String, String)

Führt die TransferData (...)-Methode des benutzerdefinierten Visualisierungsprogramms der debuggenden Seite aus.

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

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

Explizite Schnittstellenimplementierungen

IDisposable.Dispose() (Geerbt von DkmEvaluationResult)

Gilt für