Udostępnij za pośrednictwem


DkmSuccessEvaluationResult Klasa

Definicja

Sformatowany wynik pomyślnej oceny, gotowy do wyświetlenia w oknie oceny wyrażeń.

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
Dziedziczenie
Dziedziczenie
DkmSuccessEvaluationResult
Atrybuty

Właściwości

Access

Poziom kontroli dostępu (publiczny, prywatny itp.) wyniku oceny.

Address

[Opcjonalnie] Jeśli wynik jest adresem (tj. flaga adresu jest ustawiona w flagach), określa lokalizację wartości zapasowej. Jest to używane, gdy wynik oceny jest używany jako dane wejściowe okna pamięci lub okna dezasemblacji. Jeśli jest to adres instrukcji, musi mieć ustawiony adres CPUInstruction.

Category

Kategoria (np. dane, metoda itp.) tego wyniku oceny.

CustomUIVisualizers

[Opcjonalnie] Lista niestandardowych osób przeglądających dla tego obiektu.

EditableValue

[Opcjonalnie] Jeśli wartość jest zapisywalna, określa domyślny ciąg, który ma być używany po dwukrotnym kliknięciu wartości, aby ją edytować. EE powinien być w stanie przeanalizować i ocenić ten ciąg i wrócić do bieżącego wyniku oceny. Jeśli wartość jest tylko do odczytu, edytowalna wartość jest ignorowana i powinna mieć wartość null.

ExternalModules

[Opcjonalnie] Jeśli jest dostępna, lista modułów zewnętrznych, które nie zawierają bieżącego modułu, które są używane do inspekcji obiektu. Ładowanie symboli dla jak największej liczby modułów na tej liście poprawi wyświetlanie obiektu.

Flags

Flagi wskazujące atrybuty wyniku oceny wyrażenia.

FullName

[Opcjonalnie] Pełna nazwa wyrażenia, do których odnosi się ten wynik. Ta wartość służy do zezwalania na dodawanie elementów podrzędnych do okna watch (Dodawanie czujki z menu kontekstowego) i odświeżanie części drzewa oceny. Jako przykład różnicy nazwy FullName od nazwy, nazwa 0 elementu tablicy w języku C++ to "[0]", a pełna nazwa będzie następująca: "myArrayVariable[0]". W przypadku programu Visual Studio 14 i nowszych w razie potrzeby można obliczyć pełną nazwę później. W tym celu ewaluator wyrażeń powinien utworzyć element DkmEvaluationResult z pełną nazwą o wartości null i zaimplementować element IDkmFullNameProvider. Następnie program Concord wywoła metodę IDkmFullNameProvider.CalculateFullName, aby uzyskać pełną nazwę w razie potrzeby w interfejsie użytkownika.

(Odziedziczone po DkmEvaluationResult)
InspectionContext

Kontekst inspekcji użyty do utworzenia tego wyniku oceny.

(Odziedziczone po DkmEvaluationResult)
InspectionSession

InspekcjaSesja umożliwia różnym składnikom, które sprawdzają 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.

(Odziedziczone po DkmEvaluationResult)
IsUnloaded

Zwraca wartość true, jeśli dla tego obiektu zostało podniesione zdarzenie "unloaded" (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

Język używany do przeprowadzania inspekcji.

(Odziedziczone po DkmEvaluationResult)
Name

Nazwa wyrażenia, do których odnosi się ten wynik.

(Odziedziczone po DkmEvaluationResult)
RefreshButtonText

[Opcjonalnie] Gdy ustawiono wartość DkmEvaluationResultFlags::CanEvaluateNow, określa tekst wyświetlany jako etykietka narzędzia, gdy użytkownik zatrzyma wskaźnik myszy na przycisku odświeżania. Jeśli ta wartość ma wartość null, zostanie użyty komunikat domyślny.

Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

RuntimeInstance

Wskazuje, który monitor środowiska uruchomieniowego będzie używany do przeprowadzenia tej oceny.

(Odziedziczone po DkmEvaluationResult)
StackFrame

Ramka stosu utworzono ten wynik wyrażenia.

(Odziedziczone po DkmEvaluationResult)
StorageType

Typ magazynu (np. statyczny) wyniku oceny.

TagValue

DkmEvaluationResult jest abstrakcyjną klasą bazową. To wyliczenie wskazuje, która klasa pochodna jest wystąpieniem tego obiektu.

(Odziedziczone po DkmEvaluationResult)
Type

[Opcjonalnie] Ciąg opisujący typ wartości.

TypeModifierFlags

Flagi modyfikatora typu (np. const) wyniku oceny.

UniqueId

Identyfikator GUID, który jednoznacznie identyfikuje ten wynik oceny.

(Odziedziczone po DkmEvaluationResult)
Value

[Opcjonalnie] Ciąg opisujący wartość.

Metody

AddToFavorites(DkmSuccessEvaluationResult)

Dodaje określonego elementu podrzędnego do kolekcji elementów ulubionych w typie tego wyniku.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4).

Close()

Zamyka obiekt wyniku oceny, aby zwolnić skojarzone z nim zasoby. Ta metoda musi być wywoływana przez składnik, który zainicjował wyliczenie (np. O nazwie DkmInspectionContext.EvaluateExpression, DkmEvaluationResultEnumContext.GetItems itp.).

Obiekty DkmEvaluationResult są automatycznie zamykane po zamknięciu skojarzonego obiektu DkmInspectionSession.

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

Twórca nowe wystąpienie obiektu DkmSuccessEvaluationResult.

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

Twórca nowe wystąpienie obiektu DkmSuccessEvaluationResult.

Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObjectAsyncResult>)

Tworzy wystąpienie typu custom visualizer po stronie debugowania w procesie debuggee.

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ę uzupełniania.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10).

CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, Int32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObject176AsyncResult>)

Tworzy wystąpienie typu niestandardowego wizualizatora po stronie debugowania w procesie debugowania i określa typ serializacji, który ma być używany podczas komunikacji z nim.

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ę uzupełniania.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).

CreateDebuggeeSideVisualizerObject(UInt32, Int32, Int32, String, String, String, Boolean)

Tworzy wystąpienie typu niestandardowego wizualizatora po stronie debugowania w procesie debugowania i określa typ serializacji, który ma być używany podczas komunikacji z nim.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6).

CreateDebuggeeSideVisualizerObject(UInt32, String, String, String)

Tworzy wystąpienie typu custom visualizer po stronie debugowania w procesie debuggee. Uwaga: ta metoda została uznana za przestarzałą na rzecz tej zdefiniowanej w interfejsie IDkmClrCustomVisualizerObjectProvider1610.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

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

CreateDebuggeeSideVisualizerObject(UInt32, String, String, String, Boolean)

Tworzy wystąpienie typu custom visualizer po stronie debugowania w procesie debuggee.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10).

CreateObjectId()

Tworzy identyfikator obiektu dla tego określonego wyrażenia.

Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.

(Odziedziczone po DkmEvaluationResult)
CreateReplacementObjectOnDebuggeeSideVisualizer(Byte[], String, String, String)

Wykonuje metodę CreateReplacementObject(...) typu custom visualizer po stronie debugowania i zapisuje wynik do zwizualizowanego uchwytu obiektu.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

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

DestroyDebuggeeSideVisualizerObject()

Zwalnia typ debuggee-side Custom Visualizer w procesie debuggee.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

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

DestroyDebuggeeSideVisualizerObject(DkmWorkList, DkmCompletionRoutine<DkmDestroyDebuggeeSideVisualizerObjectAsyncResult>)

Zwalnia typ debuggee-side Custom Visualizer w procesie debuggee.

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 IDE (poziom > składnika 100 000).

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

DestroyObjectId()

Niszczy identyfikator obiektu dla tego określonego wyrażenia.

Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.

(Odziedziczone po DkmEvaluationResult)
ExtractFromProperty(IDebugProperty3)

Uzyskuje obiekt DkmSuccessEvaluationResult, który zastępuje obiekt IDebugProperty3. Ten interfejs API będzie działać poprawnie tylko z głównego wątku programu Visual Studio.

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

Pobiera kontekst wyliczenia używany do uzyskiwania elementów podrzędnych tego wyniku oceny. Jest to używane we wszystkich oknach oceny wyrażeń.

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ę uzupełniania.

Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.

(Odziedziczone po DkmEvaluationResult)
GetClrValue()

Pobiera podstawową wartość DkmClrValue z DkmSuccessEvaluationResult, jeśli istnieje.

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

GetDataBreakpointDisplayName()

Pobiera nazwę wyświetlaną punktu przerwania danych dla wyniku oceny.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

GetDataBreakpointDisplayName(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointDisplayNameAsyncResult>)

Pobiera nazwę wyświetlaną punktu przerwania danych dla wyniku oceny.

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 IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

GetDataBreakpointInfo(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointInfoAsyncResult>)

Zwraca informacje o punkcie przerwania danych związane z wynikiem oceny, jeśli jest to prawidłowe.

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 IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8).

GetDataBreakpointInfo(String)

Zwraca informacje o punkcie przerwania danych związane z wynikiem oceny, jeśli jest to prawidłowe.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8).

GetDataFromDebuggeeSideVisualizer(DkmWorkList, DkmCompletionRoutine<DkmGetDataFromDebuggeeSideVisualizerAsyncResult>)

Wykonuje metodę GetData(...) typu custom visualizer po stronie debuggee.

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 IDE (poziom > składnika 100 000).

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

GetDataFromDebuggeeSideVisualizer(String, String, String)

Wykonuje metodę GetData(...) typu custom visualizer po stronie debuggee.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (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 wartości "T", ta funkcja zwróci wartość null.

(Odziedziczone po DkmDataContainer)
GetUnderlyingString()

Ta metoda jest używana do oceny wyników, które obejmują DkmEvaluationResultFlags.RawString w celu uzyskania podstawowego ciągu bez cudzysłowów lub sekwencji ucieczki. Ta metoda jest wywoływana w celu wyświetlenia jednego z różnych wizualizatorów ciągów w oknie obliczania wyrażeń (kliknij ikonę lupy).

Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.

(Odziedziczone po DkmEvaluationResult)
RemoveDataItem<T>()

Usuń wystąpienie elementu "T" z tego kontenera. Zwykle wywołanie tej metody jest niepotrzebne, ponieważ kontener danych zostanie automatycznie opróżniony po zamknięciu obiektu.

(Odziedziczone po DkmDataContainer)
RemoveFromFavorites(DkmSuccessEvaluationResult)

Usuwa określone dziecko z kolekcji ulubionych elementów w typie tego wyniku.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4).

ResolveAssembly(String, String, ReadOnlyCollection<Byte>)

Rozpoznaje nazwę zestawu do ścieżki zestawu lub nieprzetworzonych bajtów.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

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

SetDataItem<T>(DkmDataCreationDisposition, T)

Umieść nowy element w kontenerze danych.

(Odziedziczone po DkmDataContainer)
SetValueAsString(String, Int32, String)

Modyfikuje wartość podanego wyniku oceny (przyjmuje się, że nie jest tylko do odczytu), aby pasować do danego ciągu. Jest to używane po zmodyfikowaniu wartości przez użytkownika w dowolnym z okien oceny.

Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.

(Odziedziczone po DkmEvaluationResult)
TransferDataToDebuggeeSideVisualizer(Byte[], String, String, String)

Wykonuje metodę TransferData(...) typu custom visualizer po stronie debuggee.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).

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

Jawne implementacje interfejsu

IDisposable.Dispose()

Sformatowany wynik pomyślnej oceny, gotowy do wyświetlenia w oknie oceny wyrażeń.

(Odziedziczone po DkmEvaluationResult)

Dotyczy