Microsoft.VisualStudio.DebuggerVisualizers Przestrzeń nazw
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.
Klasy
DialogDebuggerVisualizer |
Wszystkie niestandardowe wizualizatory debugera muszą pochodzić z tej klasy i udostępnić konstruktor bez parametrów, który ma być wywoływany przez program VS. |
VisualizerDevelopmentHost |
Klasa hosta do testowania podczas opracowywania zarządzanego niestandardowego wizualizatora. |
VisualizerObjectSource |
Zapewnia dostęp do wizualizowanego obiektu. |
VisualizerObjectSourceException |
Reprezentuje wyjątek zgłaszany po stronie debuggee — za pośrednictwem EE, infrastruktury wizualizatora (hosta debuggee) lub debuggee user-code i jest zgłaszany po stronie interfejsu użytkownika (możliwe do przechwycenia z elementu DialogDebuggerVisualizer). Jest to przybliżony odpowiednik interfejsu użytkownika Microsoft.VisualStudio.VIL.VisualStudioHost.DebuggeeVisualizerException. |
Interfejsy
IAsyncVisualizerObjectProvider |
Zapewnia implementację asynchronizową dla metod zdefiniowanych w IVisualizerObjectProvider2 programie, które zapewniają funkcjonalność przekazywania danych z debugera do wizualizatora i odwrotnie. |
IDeserializableObject |
Interfejs używany do deserializacji obiektów, gdy format bazowy (binarny lub JSON) nie jest znany. |
IDialogVisualizerService |
Udostępnia metody, które wizualizator może wywoływać do wyświetlania formularzy System.Windows, okien dialogowych i kontrolek. |
IVisualizerObjectProvider |
Udostępnia dane obiektów z debuggee do wizualizatora. |
IVisualizerObjectProvider2 |
Udostępnia dodatkowe funkcje przekazywania danych z debuggee do wizualizatora. |
IVisualizerObjectProvider3 |
Umożliwia wizualizatorowi debugera i debuggee składników bocznych współrzędnych, na których mechanizm serializacji ma być używany, oraz udostępnia dodatkowe funkcje przekazywania danych do strony debuggee, biorąc pod uwagę SelectedFormatterPolicyelement . |
Wyliczenia
FormatterPolicy |
Styl formatowania używany podczas serializacji/deserializacji informacji z obiektu VisualizerObjectSource. |
Przykłady
public class DebuggerSide : DialogDebuggerVisualizer
{
override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
{
MessageBox.Show(objectProvider.GetObject().ToString());
}
// . . . Other methods omitted for clarity.
}
Uwagi
Wizualizator to mały program, którego debuger programu Visual Studio używa do wyświetlania, czyli wizualizowania obiektu określonego typu danych w zrozumiały sposób. Aby zwizualizować obiekt, wizualizator używa kodu uruchamianego w procesie debugera (po stronie debugera) i kodu w debugowaniu ( po stronie debugera).
Strona debugera i debuggee komunikują się ze sobą przy użyciu i VisualizerObjectSource IVisualizerObjectProvider.
Strona debuggee używa VisualizerObjectSource do określenia VisualizerObjectSource obiektu po stronie debugera. Debuger żądań po stronie i odbiera te informacje, wywołując metody w interfejsie IVisualizerObjectProvider .
Wizualizator może edytować, a także wyświetlać dane. Jeśli wizualizator obsługuje edytowanie danych, musisz zastąpić je całkowicie wywołaniem ReplaceData lub ReplaceObject przeniesieniem danych z powrotem do debuggee przy użyciu polecenia TransferData lub TransferObject. Jeśli chcesz zapisać dane z powrotem, musisz również utworzyć własne źródło obiektów.