IDebugProperty2
Ten interfejs reprezentuje właściwość ramki stosu, właściwość dokumentu programu lub inną właściwość. Właściwość jest zwykle wynikiem oceny wyrażenia.
Uwaga
Użycie "właściwości" nie powinno być mylone z tym, co oznacza zmienną składową klasy, chociaż IDebugProperty2 może reprezentować taką jednostkę.
Składnia
IDebugProperty2 : IUnknown
Uwagi dotyczące implementacji
De implementuje ten interfejs, aby reprezentować określony rodzaj wartości. Na przykład wartość może być wartością liczbową w wyniku oceny wyrażenia, kontekstu pamięci używanego do wyświetlania pamięci lub listy rejestrów i ich wartości.
Uwagi dotyczące wywoływania
Wywołaj metodę EvaluateSync lub EvaluateAsync , aby uzyskać ten interfejs, który reprezentuje wynik oceny. IDebugExpression2::EvaluateAsyncZwraca ten interfejs, wysyłając interfejs IDebugExpressionEvaluationCompleteEvent2 do sdM, który z kolei wywołuje metodę GetResult w celu pobrania właściwości.
Polecenie GetDebugProperty zwraca ten interfejs w celu udostępnienia skojarzonego dokumentu skryptu.
Funkcja GetReturnValue zwraca ten interfejs w celu reprezentowania zwracanej wartości funkcji.
Polecenie GetDebugProperty zwraca ten interfejs, aby reprezentować różne właściwości programu, takie jak nazwa lub kontekst pamięci.
Polecenie GetDebugProperty zwraca ten interfejs, aby reprezentować różne właściwości ramki stosu, takie jak zmienne lokalne.
Metody w tabeli Vtable Order
W poniższej tabeli przedstawiono metody .IDebugProperty2
| Metoda | opis |
|---|---|
| GetPropertyInfo | Wypełnia strukturę DEBUG_PROPERTY_INFO opisającą właściwość. |
| SetValueAsString | Ustawia wartość właściwości z ciągu. |
| SetValueAsReference | Ustawia wartość właściwości z wartości danego odwołania. |
| EnumChildren | Wylicza elementy podrzędne właściwości. |
| GetParent | Zwraca element nadrzędny właściwości. |
| GetDerivedMostProperty | Zwraca właściwość, która opisuje najbardziej pochodną właściwość właściwości. |
| GetMemoryBytes | Zwraca bajty pamięci, które tworzą wartość właściwości. |
| GetMemoryContext | Zwraca kontekst pamięci dla wartości właściwości. |
| GetSize | Zwraca rozmiar w bajtach wartości właściwości. |
| GetReference | Zwraca odwołanie do wartości tej właściwości. |
| GetExtendedInfo | Zwraca rozszerzone informacje o właściwości. |
Uwagi
Właściwość reprezentowana przez IDebugProperty2 interfejs może być uważana za wartość o nazwie, typie i adresie. Ogólnie rzecz biorąc, element IDebugProperty2 może reprezentować wszystko, co ma strukturę hierarchiczną, z węzłami nadrzędnymi i węzłami podrzędnymi.
Właściwość jest zwykle przechodnia, trwa tylko tak długo, jak bieżąca ramka stosu, na przykład. Z drugiej strony odwołanie, reprezentowane przez interfejs IDebugReference2 , trwa tak długo, jak wartość pozostaje w pamięci.
Środowisko IDE może używać interfejsu IDebugProperty2 , aby umożliwić użytkownikom przeglądanie i modyfikowanie właściwości w czasie wykonywania.
Wymagania
Nagłówek: msdbg.h
Przestrzeń nazw: Microsoft.VisualStudio.Debugger.Interop
Zestaw: Microsoft.VisualStudio.Debugger.Interop.dll