DkmClrValue.Create Methode

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation

Assembly:: Microsoft.VisualStudio.Debugger.Engine.dll

Paket:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Create ein neues DkmClrValue-Objekt instance.

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.

public:
 static Microsoft::VisualStudio::Debugger::Evaluation::ClrCompilation::DkmClrValue ^ Create(Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionSession ^ InspectionSession, Microsoft::VisualStudio::Debugger::Evaluation::DkmLanguage ^ Language, Microsoft::VisualStudio::Debugger::Clr::DkmClrType ^ Type, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultCategory Category, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultAccessType Access, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultStorageType StorageType, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, System::Object ^ HostObjectValue, Microsoft::VisualStudio::Debugger::CallStack::DkmStackWalkFrame ^ StackFrame, Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResultFlags EvalFlags, Microsoft::VisualStudio::Debugger::Evaluation::DkmClrValueFlags ValueFlags, System::UInt64 NativeComPointer, Microsoft::VisualStudio::Debugger::Evaluation::DkmDataAddress ^ Address, System::String ^ Alias, System::Collections::ObjectModel::ReadOnlyCollection<int> ^ ArrayDimensions, System::Collections::ObjectModel::ReadOnlyCollection<int> ^ ArrayLowerBounds, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue Create(Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage Language, Microsoft.VisualStudio.Debugger.Clr.DkmClrType Type, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType Access, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType StorageType, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, object HostObjectValue, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags EvalFlags, Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags ValueFlags, ulong NativeComPointer, Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress Address, string Alias, System.Collections.ObjectModel.ReadOnlyCollection<int> ArrayDimensions, System.Collections.ObjectModel.ReadOnlyCollection<int> ArrayLowerBounds, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);

public static Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue Create(Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession InspectionSession, Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage Language, Microsoft.VisualStudio.Debugger.Clr.DkmClrType? Type, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory Category, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType Access, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType StorageType, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags TypeModifierFlags, bool IsNull, object? HostObjectValue, Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame StackFrame, Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags EvalFlags, Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags ValueFlags, ulong NativeComPointer, Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress? Address, string? Alias, System.Collections.ObjectModel.ReadOnlyCollection<int>? ArrayDimensions, System.Collections.ObjectModel.ReadOnlyCollection<int>? ArrayLowerBounds, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionSession * Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguage * Microsoft.VisualStudio.Debugger.Clr.DkmClrType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultCategory * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultAccessType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultStorageType * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultTypeModifierFlags * bool * obj * Microsoft.VisualStudio.Debugger.CallStack.DkmStackWalkFrame * Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResultFlags * Microsoft.VisualStudio.Debugger.Evaluation.DkmClrValueFlags * uint64 * Microsoft.VisualStudio.Debugger.Evaluation.DkmDataAddress * string * System.Collections.ObjectModel.ReadOnlyCollection<int> * System.Collections.ObjectModel.ReadOnlyCollection<int> * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation.DkmClrValue

Public Shared Function Create (InspectionSession As DkmInspectionSession, Language As DkmLanguage, Type As DkmClrType, Category As DkmEvaluationResultCategory, Access As DkmEvaluationResultAccessType, StorageType As DkmEvaluationResultStorageType, TypeModifierFlags As DkmEvaluationResultTypeModifierFlags, IsNull As Boolean, HostObjectValue As Object, StackFrame As DkmStackWalkFrame, EvalFlags As DkmEvaluationResultFlags, ValueFlags As DkmClrValueFlags, NativeComPointer As ULong, Address As DkmDataAddress, Alias As String, ArrayDimensions As ReadOnlyCollection(Of Integer), ArrayLowerBounds As ReadOnlyCollection(Of Integer), DataItem As DkmDataItem) As DkmClrValue

Parameter

InspectionSession: DkmInspectionSession

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

Language: DkmLanguage

[In] Die verwendete Sprache.

Type: DkmClrType

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

Category: DkmEvaluationResultCategory

[In] Die Kategorie (z. B. Daten, Methode usw.) dieses Auswertungsergebnisses.

Access: DkmEvaluationResultAccessType

[In] Die Zugriffssteuerungsebene (öffentlich, privat usw.) des Auswertungsergebnisses.

StorageType: DkmEvaluationResultStorageType

[In] Der Speichertyp (z. B. statisch) des Auswertungsergebnisses.

TypeModifierFlags: DkmEvaluationResultTypeModifierFlags

[In] Typmodifiziererflags (z. B. const) des Auswertungsergebnisses.

IsNull: Boolean

[In] True, wenn der Wert NULL ist (oder wenn kein Wert vorhanden ist).

HostObjectValue: Object

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

StackFrame: DkmStackWalkFrame

[In] Der Stapelrahmen, der als Überprüfungsrahmen des interpretierten Ausdrucks verwendet wird.

EvalFlags: DkmEvaluationResultFlags

[In] Flags, die das Ergebnis der Auswertung beschreiben, die dieses DkmClrValue erstellt hat.

ValueFlags: DkmClrValueFlags

[In] Flags, die diesen Wert beschreiben.

NativeComPointer: UInt64

[In] Ein Schnittstellenzeiger auf das native COM-Objekt, wenn dieser Wert ein RCW ist.

Address: DkmDataAddress

[In,Optional] Wenn das Ergebnis eine Adresse ist (d. h. das Adressflag ist in Flags festgelegt), gibt den Speicherort 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.

Alias: String

[In,Optional] Der Alias für diesen Wert. Wenn dem Objekt kein Alias zugewiesen wurde, ist dieser Wert NULL.

ArrayDimensions: ReadOnlyCollection<Int32>

[In,Optional] Die Dimensionen des Arrays. Dieser Wert ist nur gültig, wenn dieser DkmClrValue ein Arraywert ist.

ArrayLowerBounds: ReadOnlyCollection<Int32>

[In,Optional] Die unteren Grenzen des Arrays. Dieser Wert ist nur gültig, wenn dieser DkmClrValue ein Arraywert ist.

DataItem: DkmDataItem

[In,Optional] Datenobjekt, das dem neuen DkmClrValue-instance hinzugefügt werden soll. Übergeben Sie "NULL", falls der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmClrValue

[Out] Ergebnis dieses Methodenaufrufs.

Gilt für: