DkmClrValue Klasse

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Paket:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Ein Wert, der sich aus einer CLR-Überprüfungsabfrage ergibt. Diese Werte werden von einem Ergebnisformatierer verwendet, um DkmEvaluationResults zu generieren.

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

public ref class DkmClrValue : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable

[System.Runtime.InteropServices.Guid("8186570c-2529-edb5-ef0b-4e485f902e89")]
public class DkmClrValue : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable

[<System.Runtime.InteropServices.Guid("8186570c-2529-edb5-ef0b-4e485f902e89")>]
type DkmClrValue = class
    inherit DkmDataContainer
    interface IDisposable

Public Class DkmClrValue
Inherits DkmDataContainer
Implements IDisposable

Vererbung

Object

DkmDataContainer

DkmClrValue

Attribute

GuidAttribute

Implementiert

IDisposable

Eigenschaften

Access	Die Zugriffssteuerungsebene (öffentlich, privat usw.) des Auswertungsergebnisses. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
Address	[Optional] Wenn das Ergebnis eine Adresse ist (d. h. das Adressflag in Flags festgelegt ist), gibt die Position des Sicherungswerts an. Dies wird verwendet, wenn das Auswertungsergebnis als Eingabe für das Speicher- oder Disassemblierungsfenster verwendet wird. Wenn es sich um eine Anweisungsadresse handelt, muss die CPUInstruction-Adresse festgelegt sein. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
Alias	[Optional] Der Alias für diesen Wert. Wenn dem Objekt kein Alias zugewiesen wurde, ist dieser Wert NULL. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
ArrayDimensions	[Optional] Die Dimensionen des Arrays. Dieser Wert ist nur gültig, wenn dieser DkmClrValue ein Arraywert ist. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
ArrayLowerBounds	[Optional] Die unteren Grenzen des Arrays. Dieser Wert ist nur gültig, wenn dieser DkmClrValue ein Arraywert ist. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
Category	Die Kategorie (z. B. Daten, Methode usw.) dieses Auswertungsergebnisses. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
EvalFlags	Flags, die das Ergebnis der Auswertung beschreiben, die diese DkmClrValue erstellt hat. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
HostObjectValue	[Optional] Der Wert dieses Knotens, wenn DkmClrValue ein Wert ist, der im Debuggerprozess dargestellt werden kann. Wenn DkmClrValue einen komplexen Typ aufweist, ist dieser Wert NULL. Hinweis zur Verwendung in systemeigenem Code, wenn der zugrunde liegende Wert eine Zeichenfolge ist: Wenn Sie dieses Feld im nativen Code verwenden, kann die VARIANT-Struktur BSTR oder ein IUnknown sein, der nach IDkmManagedStringRef abgefragt werden sollte. Wenn Sie dieses Feld im nativen Code erstellen, verwenden Sie einen VARIANT-Wert eines BSTR. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
InspectionSession	Die InspectionSession ermöglicht es den verschiedenen Komponenten, die Daten im Zielprozess untersuchen, private Daten mit derselben Lebensdauer zu speichern. Inspektionssitzungen werden geschlossen, wenn der Benutzer versucht, den Prozess fortzusetzen. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
IsNull	True, wenn der Wert NULL ist (oder wenn kein Wert vorhanden ist). Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
IsUnloaded	Gibt true zurück, wenn ein "entladenes" Ereignis für dieses Objekt ausgelöst wurde (Beispiel: DkmThread::Unload wird aufgerufen) oder wenn das Objekt geschlossen wurde. Beachten Sie, dass beim Überprüfen dieser status sorgfältig darauf geachtet werden muss, dass die zurückgegebene status nach dem Lesen möglicherweise nicht mehr korrekt ist. (Geerbt von DkmDataContainer)
Language	Die verwendete Sprache. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
NativeComPointer	Ein Schnittstellenzeiger auf das native COM-Objekt, wenn dieser Wert ein RCW ist. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
StackFrame	Der Stapelrahmen, der als Überprüfungsrahmen des interpretierten Ausdrucks verwendet wird. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
StorageType	Der Speichertyp (z. B. statisch) des Auswertungsergebnisses. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
Type	[Optional] Der Laufzeittyp dieses Knotens. System.String, z. B. Dieser Wert ist NULL, wenn der Wert ungültig ist UND der Typ nicht bestimmt werden kann. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
TypeModifierFlags	Typmodifiziererflags (z. B. const) des Auswertungsergebnisses. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
UniqueId	Guid, die dieses interpretierte Ergebnis eindeutig identifiziert. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
ValueFlags	Flags, die diesen Wert beschreiben. Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.

Methoden

Close()	Schließt den CLR-Wert, um zugeordnete Ressourcen freizugeben. Diese Methode muss von dem Objekt aufgerufen werden, das die Auswertungsabfrage angefordert hat (z. B. DkmCompiledClrInspectionQuery.Execute). DkmClrValue-Objekte werden automatisch geschlossen, wenn ihr zugeordnetes DkmInspectionSession-Objekt geschlossen wird. 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.
Create(DkmInspectionSession, DkmLanguage, DkmClrType, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, Boolean, Object, DkmStackWalkFrame, DkmEvaluationResultFlags, DkmClrValueFlags, UInt64, DkmDataAddress, String, ReadOnlyCollection<Int32>, ReadOnlyCollection<Int32>, DkmDataItem)	Create ein neues DkmClrValue-Objekt instance. 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.
Dereference(DkmInspectionContext)	Leiten Sie diesen Zeigerwert ab, um den zugrunde liegenden Wert abzurufen. Diese Methode kann nur verwendet werden, wenn DkmClrValue einen Pointer-Wert darstellt. 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.
EvaluateDebuggerDisplayString(DkmWorkList, DkmInspectionContext, DkmClrType, String, DkmCompletionRoutine<DkmEvaluateDebuggerDisplayStringAsyncResult>)	Ruft die Zeichenfolge ab, die auf der Debugger-Benutzeroberfläche für einen CLR-Wert mit einer DebuggerDisplay-Attributzeichenfolge angezeigt werden soll. 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 Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
EvaluateToString(DkmInspectionContext)	Führen Sie die ToString-Überschreibung für ein Objekt aus, das durch den angegebenen DkmClrValue dargestellt wird. Wenn der Wert vom Typ object ist oder ToString nicht überschreibt, gibt diese Methode NULL zurück. Für diese Methode muss die Funktionsauswertung aktiviert sein. Wenn die Funktionsauswertung vom Benutzer oder aus einem anderen Grund deaktiviert ist, gibt diese Methode NULL zurück. Diese Methode gibt auch NULL zurück, wenn die Funktionsauswertung aus irgendeinem Grund fehlschlägt. 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.
GetArrayElement(Int32[], DkmInspectionContext)	Rufen Sie ein Arrayelement ab. Diese Methode kann nur verwendet werden, wenn DkmClrValue einen Arraywert darstellt. 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.
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)
GetEditableValueString(DkmInspectionContext, DkmClrCustomTypeInfo)	Rufen Sie die bearbeitbare Wertzeichenfolge ab, die auf der Benutzeroberfläche für den angegebenen DkmClrValue angezeigt werden soll. 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.
GetMemberValue(String, Int32, String, DkmInspectionContext)	Ruft den Wert eines Felds oder einer Eigenschaft als DkmClrValue ab. 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.
GetResult(DkmWorkList, DkmClrType, DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>, String, String, DkmCompletionRoutine<DkmEvaluationAsyncResult>)	Formatieren Sie einen DkmClrValue, und geben Sie ein DkmEvaluationResult zurück. 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 Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000). Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
GetUnderlyingString(DkmInspectionContext)	Rufen Sie die zugrunde liegende Zeichenfolgendarstellung des Werts ab. 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.
GetValueString(DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>)	Rufen Sie die Wertzeichenfolge ab, die auf der Benutzeroberfläche für den angegebenen DkmClrValue angezeigt werden soll. 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.
GetValueString(DkmInspectionContext, ReadOnlyCollection<String>)	Rufen Sie die Wertzeichenfolge ab, die auf der Benutzeroberfläche für den angegebenen DkmClrValue angezeigt werden soll. 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.
HasUnderlyingString(DkmInspectionContext)	Bestimmt, ob dieser Wert eine zugrunde liegende Zeichenfolgendarstellung aufweist. Wenn diese Methode true zurückgibt, kann der Benutzer Zeichenfolgenvisualisierer verwenden, um diesen Wert im Debugger anzuzeigen. GetUnderlyingString sollte die zugrunde liegende Zeichenfolgendarstellung zurückgeben. Standorteinschrä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.
InstantiateDynamicViewProxy(DkmInspectionContext)	Instanziieren Sie die Proxyklasse, die zum Durchlaufen der dynamischen Member eines IDynamicMetaObjectProvider-Werts verwendet werden soll. Standorteinschrä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.
InstantiateProxyType(DkmInspectionContext, DkmClrType)	Instanziieren Sie eine Proxyklasse für ein DkmClrValue-Objekt mit einem zugeordneten DebuggerTypeProxy-Attribut. Standorteinschrä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.
InstantiateResultsViewProxy(DkmInspectionContext, DkmClrType)	Instanziieren Sie die Proxyklasse, die zum Iterieren eines IEnumerable-Werts verwendet werden soll. Standorteinschrä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.
RemoveDataItem<T>()	Entfernen Sie den 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)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Muss hinzugefügt werden.