DkmClrValue Klasa

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation

Zestaw:: Microsoft.VisualStudio.Debugger.Engine.dll

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

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wartość wynikająca z zapytania inspekcji CLR. Te wartości są używane przez moduł formatujący wynik do generowania wartości DkmEvaluationResults.

Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

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

Dziedziczenie: MarshalByRefObject

DkmDataContainer
DkmClrValue

Dziedziczenie: Object

DkmDataContainer
DkmClrValue

Atrybuty: GuidAttribute

Implementuje: IDisposable

Właściwości

Access	Poziom kontroli dostępu (publiczny, prywatny itp.) wyniku oceny. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Address	[Opcjonalnie] Jeśli wynik jest adresem (tj. flaga adresu jest ustawiona w flagach), określa lokalizację wartości kopii zapasowej. Jest to używane, gdy wynik oceny jest używany jako dane wejściowe do okna pamięci lub okna dezasemblowania. Jeśli jest to adres instrukcji, musi mieć ustawiony adres CPUInstruction. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Alias	[Opcjonalnie] Alias dla tej wartości. Jeśli obiekt nie został przypisany alias, ta wartość będzie mieć wartość null. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ArrayDimensions	[Opcjonalnie] Wymiary tablicy. Ta wartość jest prawidłowa tylko wtedy, gdy ta wartość DkmClrValue jest wartością tablicy. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ArrayLowerBounds	[Opcjonalnie] Dolne granice tablicy. Ta wartość jest prawidłowa tylko wtedy, gdy ta wartość DkmClrValue jest wartością tablicy. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Category	Kategoria (np. dane, metoda itp.) tego wyniku oceny. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
EvalFlags	Flagi opisujące wynik oceny, która utworzyła tę wartość DkmClrValue. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
HostObjectValue	[Opcjonalnie] Wartość tego węzła, jeśli DkmClrValue jest wartością, którą można przedstawić w procesie debugera. Jeśli wartość DkmClrValue jest typu złożonego, ta wartość będzie mieć wartość null. Uwaga dotycząca użycia w kodzie natywnym, gdy wartość bazowa jest ciągiem: jeśli używasz tego pola w kodzie natywnym, struktura VARIANT może być BSTR lub IUnknown, która powinna być odpytywana dla elementu IDkmManagedStringRef. Jeśli tworzysz to pole w kodzie natywnym, użyj wariantu BSTR. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InspectionSession	Funkcja InspectionSession umożliwia różnym składnikom, które badają dane w procesie docelowym w celu przechowywania danych prywatnych z tym samym okresem istnienia. Sesje inspekcji są zamykane, gdy użytkownik próbuje kontynuować proces. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
IsNull	Prawda, jeśli wartość ma wartość null (lub jeśli nie ma wartości). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
IsUnloaded	Zwraca wartość true, jeśli dla tego obiektu zostało zgłoszone zdarzenie "zwolniony" (na przykład: DkmThread::Unload jest wywoływane) lub jeśli obiekt został zamknięty. Należy pamiętać, że podczas sprawdzania tego stanu należy zachować ostrożność, ponieważ bez synchronizacji zwrócony stan może nie być już dokładny po odczytaniu instrukcji. (Odziedziczone po DkmDataContainer)
Language	Używany język. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
NativeComPointer	Wskaźnik interfejsu do natywnego obiektu COM, jeśli ta wartość jest RCW. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
StackFrame	Ramka stosu używana jako ramka inspekcji interpretowanego wyrażenia. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
StorageType	Typ magazynu (np. statyczny) wyniku oceny. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Type	[Opcjonalnie] Typ środowiska uruchomieniowego tego węzła. System.String, na przykład. Ta wartość ma wartość null, gdy wartość jest nieprawidłowa i nie można określić typu. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
TypeModifierFlags	Flagi modyfikatora typu (np. const) wyniku oceny. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
UniqueId	Identyfikator GUID, który jednoznacznie identyfikuje ten interpretowany wynik. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ValueFlags	Flagi opisujące tę wartość. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

Metody

Close()	Zamyka wartość CLR, aby zwolnić skojarzone z nią zasoby. Ta metoda musi być wywoływana przez obiekt, który zażądał kwerendy ewaluacyjnej (np. DkmCompiledClrInspectionQuery.Execute). Obiekty DkmClrValue są automatycznie zamykane po zamknięciu skojarzonego obiektu DkmInspectionSession. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Create(DkmInspectionSession, DkmLanguage, DkmClrType, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, Boolean, Object, DkmStackWalkFrame, DkmEvaluationResultFlags, DkmClrValueFlags, UInt64, DkmDataAddress, String, ReadOnlyCollection<Int32>, ReadOnlyCollection<Int32>, DkmDataItem)	Twórca nowe wystąpienie obiektu DkmClrValue. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Dereference(DkmInspectionContext)	Odrocz tę wartość wskaźnika, aby uzyskać wartość podstawową. Ta metoda może być używana tylko wtedy, gdy wartość DkmClrValue reprezentuje wartość wskaźnika. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
EvaluateDebuggerDisplayString(DkmWorkList, DkmInspectionContext, DkmClrType, String, DkmCompletionRoutine<DkmEvaluateDebuggerDisplayStringAsyncResult>)	Pobiera ciąg do wyświetlenia w interfejsie użytkownika debugera dla wartości CLR przy użyciu ciągu atrybutu DebuggerDisplay. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę ukończenia. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
EvaluateToString(DkmInspectionContext)	Wykonaj przesłonięcia ToString na obiekcie reprezentowanym przez daną wartość DkmClrValue. Jeśli wartość jest typu object lub nie zastępuje toString, ta metoda zwróci wartość null. Ta metoda wymaga włączenia oceny funkcji. Jeśli ocena funkcji jest wyłączona przez użytkownika lub z innego powodu, ta metoda zwróci wartość null. Ta metoda zwróci również wartość null, jeśli ocena funkcji zakończy się niepowodzeniem z jakiegokolwiek powodu. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetArrayElement(Int32[], DkmInspectionContext)	Pobierz element tablicy. Ta metoda może być używana tylko wtedy, gdy DkmClrValue reprezentuje wartość tablicy. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetDataItem<T>()	Pobiera wystąpienie elementu "T", które zostało dodane do tego wystąpienia kontenera. Jeśli ten kontener nie zawiera ciągu "T", ta funkcja zwróci wartość null. (Odziedziczone po DkmDataContainer)
GetEditableValueString(DkmInspectionContext, DkmClrCustomTypeInfo)	Pobierz edytowalny ciąg wartości do wyświetlenia w interfejsie użytkownika dla danej wartości DkmClrValue. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetMemberValue(String, Int32, String, DkmInspectionContext)	Pobiera wartość pola lub właściwości jako wartość DkmClrValue. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetResult(DkmWorkList, DkmClrType, DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>, String, String, DkmCompletionRoutine<DkmEvaluationAsyncResult>)	Sformatuj wartość DkmClrValue i zwróć wartość DkmEvaluationResult. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę ukończenia. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetUnderlyingString(DkmInspectionContext)	Pobierz podstawową reprezentację ciągu wartości. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetValueString(DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>)	Pobierz ciąg wartości do wyświetlenia w interfejsie użytkownika dla danej wartości DkmClrValue. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetValueString(DkmInspectionContext, ReadOnlyCollection<String>)	Pobierz ciąg wartości do wyświetlenia w interfejsie użytkownika dla danej wartości DkmClrValue. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
HasUnderlyingString(DkmInspectionContext)	Określa, czy ta wartość ma podstawową reprezentację ciągu. Jeśli ta metoda zwróci wartość true, użytkownik może użyć wizualizatorów ciągów, aby wyświetlić tę wartość w debugerze. Polecenie GetUnderlyingString powinno zwrócić podstawową reprezentację ciągu. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InstantiateDynamicViewProxy(DkmInspectionContext)	Utwórz wystąpienie klasy serwera proxy w celu iterowania dynamicznych składowych wartości IDynamicMetaObjectProvider. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InstantiateProxyType(DkmInspectionContext, DkmClrType)	Utwórz wystąpienie klasy serwera proxy dla klasy DkmClrValue ze skojarzonym atrybutem DebuggerTypeProxy. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InstantiateResultsViewProxy(DkmInspectionContext, DkmClrType)	Utwórz wystąpienie klasy serwera proxy, aby była używana do iterowania wartości IEnumerable. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
RemoveDataItem<T>()	Usuń wystąpienie "T" z tego kontenera. Zwykle nie trzeba wywoływać tej metody, ponieważ kontener danych zostanie automatycznie opróżniony po zamknięciu obiektu. (Odziedziczone po DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)	Umieść nowy element w kontenerze danych. (Odziedziczone po DkmDataContainer)

Jawne implementacje interfejsu

IDisposable.Dispose()

Do dodania.

Dotyczy

Share via