DkmSuccessEvaluationResult Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Formátovaný výsledek úspěšného vyhodnocení připravený k zobrazení v okně vyhodnocení výrazu.
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
- Dědičnost
- Dědičnost
- Atributy
Vlastnosti
Access |
Úroveň řízení přístupu (veřejná, soukromá atd.) výsledku vyhodnocení. |
Address |
[Volitelné] Pokud je výsledkem adresa (tj. příznak adresy je nastaven v části Příznaky), určuje umístění záložní hodnoty. Používá se při použití výsledku vyhodnocení jako vstup do okna paměti nebo při demontáži okna. Pokud se jedná o instrukční adresu, musí mít nastavenou adresu CPUInstruction. |
Category |
Kategorie (například Data, Metoda atd.) tohoto výsledku vyhodnocení |
CustomUIVisualizers |
[Volitelné] Seznam vlastních prohlížečů pro tento objekt. |
EditableValue |
[Volitelné] Pokud je hodnota zapisovatelná, určuje výchozí řetězec, který se má použít, když na hodnotu poklikáním upravíte. EE by měl být schopen analyzovat a vyhodnotit tento řetězec a získat zpět aktuální výsledek vyhodnocení. Pokud je hodnota jen pro čtení, bude upravitelná hodnota ignorována a měla by mít hodnotu null. |
ExternalModules |
[Volitelné] Pokud je k dispozici, seznam externích modulů, včetně aktuálního modulu, které se používají ke kontrole objektu. Načtení symbolů pro co nejvíce modulů v tomto seznamu zlepší zobrazení objektu. |
Flags |
Příznaky označující atributy výsledku vyhodnocení výrazu. |
FullName |
[Volitelné] Úplný název výrazu, na který se tento výsledek vztahuje. Tato hodnota se používá k tomu, aby bylo možné přidat podřízené prvky do okna watch (Přidat kukátko z místní nabídky) a aktualizovat části stromu vyhodnocení. Jako příklad, jak se FullName liší od názvu, název 0. elementu pole v C++ je "[0]", zatímco úplný název by 'myArrayVariable[0]'. V případě sady Visual Studio 14 a novějších je možné v případě potřeby vypočítat celé jméno později. K tomu by měl vyhodnocovací nástroj výrazu vytvořit DkmEvaluationResult s úplným názvem null a implementovat IDkmFullNameProvider. Concord pak zavolá IDkmFullNameProvider.CalculateFullName, aby v případě potřeby v uživatelském rozhraní získal celé jméno. (Zděděno od DkmEvaluationResult) |
InspectionContext |
Kontext kontroly použitý k vytvoření tohoto výsledku vyhodnocení. (Zděděno od DkmEvaluationResult) |
InspectionSession |
InspectionSession umožňuje různým komponentám, které zkoumají data v cílovém procesu, ukládat soukromá data se stejnou životností. Relace kontroly se ukončí, když se uživatel pokusí pokračovat v procesu. (Zděděno od DkmEvaluationResult) |
IsUnloaded |
Vrátí hodnotu true, pokud byla pro tento objekt vyvolána událost unloaded (příklad: DkmThread::Unload je volána) nebo pokud byl objekt uzavřen. Mějte na paměti, že při kontrole tohoto stavu je potřeba střídmět, protože bez synchronizace nemusí být vrácený stav po přečtení přesný. (Zděděno od DkmDataContainer) |
Language |
Jazyk používaný k provádění kontrol. (Zděděno od DkmEvaluationResult) |
Name |
Název výrazu, na který se tento výsledek vztahuje. (Zděděno od DkmEvaluationResult) |
RefreshButtonText |
[Volitelné] Když je DkmEvaluationResultFlags::CanEvaluateNow nastavená, určuje text, který se má zobrazit jako popis, když uživatel najede myší na tlačítko aktualizace. Pokud je tato hodnota null, použije se výchozí zpráva. Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 RTM (DkmApiVersion.VS15RTM). |
RuntimeInstance |
Určuje, které monitorování modulu runtime se použije k provedení tohoto vyhodnocení. (Zděděno od DkmEvaluationResult) |
StackFrame |
Rámec zásobníku, pro který byl výsledek výrazu vytvořen. (Zděděno od DkmEvaluationResult) |
StorageType |
Typ úložiště (např. statický) výsledku vyhodnocení. |
TagValue |
DkmEvaluationResult je abstraktní základní třída. Tento výčet označuje, které odvozené třídy je tento objekt instancí. (Zděděno od DkmEvaluationResult) |
Type |
[Volitelné] Řetězec, který popisuje typ hodnoty. |
TypeModifierFlags |
Příznaky modifikátoru typu (např. const) výsledku vyhodnocení. |
UniqueId |
Identifikátor GUID, který jednoznačně identifikuje tento výsledek vyhodnocení. (Zděděno od DkmEvaluationResult) |
Value |
[Volitelné] Řetězec, který popisuje hodnotu. |
Metody
AddToFavorites(DkmSuccessEvaluationResult) |
Přidá zadaný podřízený objekt do kolekce oblíbených položek podle typu tohoto výsledku. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4). |
Close() |
Zavře objekt výsledku vyhodnocení a uvolní k němu přidružené prostředky. Tuto metodu musí vyvolat komponenta, která spustila výčet (například s názvem DkmInspectionContext.EvaluateExpression, DkmEvaluationResultEnumContext.GetItems atd.). Objekty DkmEvaluationResult jsou automaticky uzavřeny, když je uzavřen jejich přidružený objekt DkmInspectionSession. (Zděděno od DkmEvaluationResult) |
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, DkmDataItem) |
Create novou instanci objektu DkmSuccessEvaluationResult. |
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, String, DkmDataItem) |
Create novou instanci objektu DkmSuccessEvaluationResult. Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 RTM (DkmApiVersion.VS15RTM). |
CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObjectAsyncResult>) |
Vytvoří instanci vlastního vizualizéru na straně ladění v procesu ladění. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10). |
CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, Int32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObject176AsyncResult>) |
Vytvoří instanci typu vlastního vizualizéru na straně ladění v procesu ladění a určuje typ serializace, který se má použít při komunikaci s ním. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6). |
CreateDebuggeeSideVisualizerObject(UInt32, Int32, Int32, String, String, String, Boolean) |
Vytvoří instanci typu vlastního vizualizéru na straně ladění v procesu ladění a určuje typ serializace, který se má použít při komunikaci s ním. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6). |
CreateDebuggeeSideVisualizerObject(UInt32, String, String, String) |
Vytvoří instanci vlastního vizualizéru na straně ladění v procesu ladění. Poznámka: Tato metoda byla zastaralá ve prospěch metody definované v rozhraní IDkmClrCustomVisualizerObjectProvider1610. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
CreateDebuggeeSideVisualizerObject(UInt32, String, String, String, Boolean) |
Vytvoří instanci vlastního vizualizéru na straně ladění v procesu ladění. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10). |
CreateObjectId() |
Vytvoří ID objektu pro tento konkrétní výraz. Omezení umístění: Komponenty integrovaného vývojového prostředí můžou tuto metodu volat bez ohledu na to, jaký typ kódu se ladí. Tato metoda je v současné době také podporována pro komponenty monitorování ladění při ladění kódu spuštěného v rámci CLR; tato funkce však může být v budoucí verzi odebrána. (Zděděno od DkmEvaluationResult) |
CreateReplacementObjectOnDebuggeeSideVisualizer(Byte[], String, String, String) |
Spustí metodu CreateReplacementObject(...) vlastního vizualizéru na straně ladění a zapíše výsledek do vizualizovaného objektového popisovače. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
DestroyDebuggeeSideVisualizerObject() |
Uvolní typ vlastního vizualizéru na straně ladění. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
DestroyDebuggeeSideVisualizerObject(DkmWorkList, DkmCompletionRoutine<DkmDestroyDebuggeeSideVisualizerObjectAsyncResult>) |
Uvolní typ vlastního vizualizéru na straně ladění. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
DestroyObjectId() |
Zničí ID objektu pro tento konkrétní výraz. Omezení umístění: Komponenty integrovaného vývojového prostředí můžou tuto metodu volat bez ohledu na to, jaký typ kódu se ladí. Tato metoda je v současné době také podporována pro komponenty monitorování ladění při ladění kódu spuštěného v rámci CLR; tato funkce však může být v budoucí verzi odebrána. (Zděděno od DkmEvaluationResult) |
ExtractFromProperty(IDebugProperty3) |
Získá DkmSuccessEvaluationResult objekt, který vrátí IDebugProperty3 objekt. Toto rozhraní API bude správně fungovat pouze z hlavního vlákna sady Visual Studio. |
GetChildren(DkmWorkList, Int32, DkmInspectionContext, DkmCompletionRoutine<DkmGetChildrenAsyncResult>) |
Získá kontext výčtu použitý k získání podřízených výsledků tohoto vyhodnocení. Používá se ve všech oknech vyhodnocení výrazů. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Komponenty integrovaného vývojového prostředí můžou tuto metodu volat bez ohledu na to, jaký typ kódu se ladí. Tato metoda je v současné době také podporována pro komponenty monitorování ladění při ladění kódu spuštěného v rámci CLR; tato funkce však může být v budoucí verzi odebrána. (Zděděno od DkmEvaluationResult) |
GetClrValue() |
Získá základní hodnotu DkmClrValue z DkmSuccessEvaluationResult, pokud existuje. Omezení umístění: Rozhraní API se musí volat z komponenty monitoru (úroveň < komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
GetDataBreakpointDisplayName() |
Získá zobrazovaný název zarážky dat pro výsledek vyhodnocení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTM). |
GetDataBreakpointDisplayName(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointDisplayNameAsyncResult>) |
Získá zobrazovaný název zarážky dat pro výsledek vyhodnocení. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTM). |
GetDataBreakpointInfo(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointInfoAsyncResult>) |
Pokud je platný, vrátí informace o zarážce dat související s výsledkem vyhodnocení. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8). |
GetDataBreakpointInfo(String) |
Pokud je platný, vrátí informace o zarážce dat související s výsledkem vyhodnocení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8). |
GetDataFromDebuggeeSideVisualizer(DkmWorkList, DkmCompletionRoutine<DkmGetDataFromDebuggeeSideVisualizerAsyncResult>) |
Spustí metodu GetData(...) typu vlastního vizualizéru na straně ladění. Tato metoda přidá novou pracovní položku do zadaného pracovního seznamu a vrátí po připojení pracovní položky. Skutečné zpracování pracovní položky je asynchronní. Volající bude upozorněn, že žádost je dokončena prostřednictvím rutiny dokončení. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
GetDataFromDebuggeeSideVisualizer(String, String, String) |
Spustí metodu GetData(...) typu vlastního vizualizéru na straně ladění. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
GetDataItem<T>() |
Získá instanci T, která byla přidána do této instance kontejneru. Pokud tento kontejner neobsahuje "T", vrátí tato funkce hodnotu null. (Zděděno od DkmDataContainer) |
GetUnderlyingString() |
Tato metoda se používá pro výsledky vyhodnocení, které zahrnují DkmEvaluationResultFlags.RawString k získání podkladového řetězce bez uvozovek nebo řídicích sekvencí. Tato metoda je vyvolána k zobrazení jednoho z různých vizualizérů řetězců v okně vyhodnocení výrazu (klikněte na ikonu lupy). Omezení umístění: Komponenty integrovaného vývojového prostředí můžou tuto metodu volat bez ohledu na to, jaký typ kódu se ladí. Tato metoda je v současné době také podporována pro komponenty monitorování ladění při ladění kódu spuštěného v rámci CLR; tato funkce však může být v budoucí verzi odebrána. (Zděděno od DkmEvaluationResult) |
RemoveDataItem<T>() |
Odeberte z tohoto kontejneru instanci T. Obvykle není nutné volat tuto metodu, protože kontejner dat se automaticky vyprázdní při zavření objektu. (Zděděno od DkmDataContainer) |
RemoveFromFavorites(DkmSuccessEvaluationResult) |
Odebere zadaný podřízený objekt z kolekce oblíbených položek podle typu tohoto výsledku. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4). |
ResolveAssembly(String, String, ReadOnlyCollection<Byte>) |
Přeloží název sestavení na cestu sestavení nebo jeho nezpracované bajty. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
SetDataItem<T>(DkmDataCreationDisposition, T) |
Do kontejneru dat umístěte novou položku. (Zděděno od DkmDataContainer) |
SetValueAsString(String, Int32, String) |
Upraví hodnotu daného výsledku vyhodnocení (předpokládá se, že není jen pro čtení) tak, aby odpovídala danému řetězci. Použije se poté, co uživatel upraví hodnotu v libovolném zkušebním okně. Omezení umístění: Komponenty integrovaného vývojového prostředí můžou tuto metodu volat bez ohledu na to, jaký typ kódu se ladí. Tato metoda je v současné době také podporována pro komponenty monitorování ladění při ladění kódu spuštěného v rámci CLR; tato funkce však může být v budoucí verzi odebrána. (Zděděno od DkmEvaluationResult) |
TransferDataToDebuggeeSideVisualizer(Byte[], String, String, String) |
Spustí metodu TransferData(...) typu vlastního vizualizéru na straně ladění. Omezení umístění: Rozhraní API se musí volat z komponenty IDE (úroveň > komponenty 100 000). Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
Explicitní implementace rozhraní
IDisposable.Dispose() |
Formátovaný výsledek úspěšného vyhodnocení připravený k zobrazení v okně vyhodnocení výrazu. (Zděděno od DkmEvaluationResult) |