Názorný postup: Zápis Visualizer v jazyce Visual Basic

Článek
02/28/2013

Tento názorný postup ukazuje, jak napsat pomocí jednoduchého visualizer Visual Basic.Visualizer, které vytvoříte v tomto návodu zobrazí obsah řetězce pomocí model Windows Forms zprávou.Tento jednoduchý řetězec visualizer je základní příklad chcete zobrazit, jak lze vytvořit visualizers pro jiné typy dat pro další projekty.

[!POZNÁMKA]

Dialogová okna a příkazy nabídek, které vidíte, se mohou lišit od těch popsaných v nápovědě v závislosti na aktivních nastaveních nebo edici.Chcete-li změnit nastavení, přejděte Nástroje nabídky a zvolte Import a Export .Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Visualizer kód musí být umístěn v knihovně DLL, který přečte ladicí program.Prvním krokem je vytvoření třídy projektu knihovny pro knihovnu DLL.

Vytvoření a přípravě projektu knihovny třídy

Vytvoření projektu knihovny tříd

Na soubor nabídce zvolte Nový a na Nový projekt.
V Nový projekt dialogovém okně vyberte v seznamu Typ projektus, klepněte na tlačítko Visual Basic.
V šablony klepněte na tlačítko Knihovna tříd.
V název zadejte vhodný název knihovny třídy, například MyFirstVisualizer.
Klikněte na tlačítko OK.

Při vytvoření knihovny třídy musíte přidat odkaz na Microsoft.VisualStudio.DebuggerVisualizers.DLL, aby tam pomocí definovaných tříd.Nejprve však můžete dát projektu smysluplný název.

Přejmenování Class1.vb a přidat Microsoft.VisualStudio.DebuggerVisualizers

V Aplikaci Solution Explorer, klepněte pravým tlačítkem na Class1.vba v místní nabídce klepněte na příkaz Přejmenovat.
Změňte název z Class1.vb na určité akce, například DebuggerSide.vb.

[!POZNÁMKA]

Visual Studiodeklarace třídy v DebuggerSide.vb odpovídající nový název souboru se automaticky změní.
V Aplikaci Solution Explorer, klepněte pravým tlačítkem na Můj první Visualizera v místní nabídce klepněte na příkaz Přidat odkaz na.
V Přidat odkaz na v dialogovém okně pole .NET kartu, klepněte na tlačítko Microsoft.VisualStudio.DebuggerVisualizers.DLL.
Klikněte na tlačítko OK.
V DebuggerSide.vb, přidejte následující příkaz Imports příkazy:
```
Imports Microsoft.VisualStudio.DebuggerVisualizers
```

Přidat kód straně Debugger

Nyní jste připraveni vytvořit kód straně ladicí program.Toto je kód, který běží v rámci ladicího programu k zobrazení informací, které chcete vizualizovat.Nejprve je nutné změnit prohlášení DebuggerSide objekt tak, aby se dědí ze základní třídy DialogDebuggerVisualizer.

Z DialogDebuggerVisualizer

V DebuggerSide.vb přejděte na následující řádek kódu:
```
Public Class DebuggerSide
```

Upravte kód tak, že vypadá takto:

Public Class DebuggerSide
Inherits DialogDebuggerVisualizer

DialogDebuggerVisualizermá jeden abstraktní metodu Show, který musí přepsat.

Potlačení metody DialogDebuggerVisualizer.Show

V public class DebuggerSide, přidejte následující metodu:

Protected Overrides Sub Show(ByVal windowService As Microsoft.VisualStudio.DebuggerVisualizers.IDialogVisualizerService, ByVal objectProvider As Microsoft.VisualStudio.DebuggerVisualizers.IVisualizerObjectProvider)

    End Sub

Show Metoda obsahuje kód, který skutečně dialogové okno visualizer nebo jiných prvků uživatelského rozhraní vytvoří a zobrazí informace, který byl předán visualizer z ladicího programu.Je třeba přidat kód, který vytvoří dialogové okno a zobrazí informace.V tomto návodu je to pomocí model Windows Forms zprávou.Nejprve musíte přidat odkaz a Imports za System.Windows.Forms.

Aby bylo povoleno přidat

V Aplikaci Solution Explorer, klepněte pravým tlačítkem na odkazya v místní nabídce klepněte na příkaz Přidat odkaz na.
V Přidat odkaz na v dialogovém okně pole .NET kartu, klepněte na tlačítko bylo povoleno.
Klikněte na tlačítko OK.
V DebuggerSide.cs, přidejte následující příkaz Imports příkazy:
```
Imports System.Windows.Forms
```

Vytvoření uživatelského rozhraní aplikace Visualizer

Nyní přidáte k vytvoření a zobrazení uživatelského rozhraní pro vaše visualizer kód.Toto je vaše první visualizer, bude udržovat jednoduché uživatelské rozhraní a okno se zprávou.

V dialogovém okně zobrazit výstup visualizer

V Show metodou, přidejte následující řádek kódu:
```
MessageBox.Show(objectProvider.GetObject().ToString())
```
Tento příklad kódu nezahrnuje zpracování chyb.Zpracování chyb v reálném visualizer nebo jakékoli jiné aplikace by měla zahrnovat.
Na sestavení nabídky, klepněte na tlačítko Sestavení MyFirstVisualizer.Projekt by měl sestavit úspěšně.Před pokračováním opravte všechny chyby sestavení.

Přidejte atribut nezbytné

To je konec debugger straně kódu.Je však jeden krok: zahrnuje atribut oznamující straně debuggee, které je kolekce tříd visualizer.

Přidat kód na straně debugee

Přidejte následující kód atribut DebuggerSide.vb, po Imports příkazy ale před namespace MyFirstVisualizer:

<Assembly: System.Diagnostics.DebuggerVisualizer(GetType(MyFirstVisualizer.DebuggerSide), GetType(VisualizerObjectSource), Target:=GetType(System.String), Description:="My First Visualizer")>

Na sestavení nabídky, klepněte na tlačítko Sestavení MyFirstVisualizer.Projekt by měl sestavit úspěšně.Před pokračováním opravte všechny chyby sestavení.

Vytvořit testovací

V tomto okamžiku je vaše první visualizer dokončení.Pokud jste postupovali podle kroků správně, můžete sestavit visualizer a nainstalujte jej do Visual Studio.Před instalací visualizer do Visual Studio, však měli otestovat a zajistit, že pracuje správně.Nyní vytvoří testovací vodiče visualizer spustit bez instalace do Visual Studio.

Přidat zkušební metoda zobrazení visualizer

Přidejte následující metodu třídy public DebuggerSide:

Shared Public Sub TestShowVisualizer(ByVal objectToVisualize As Object)
    Dim visualizerHost As New VisualizerDevelopmentHost(objectToVisualize, GetType(DebuggerSide))
visualizerHost.ShowVisualizer()
End Sub

Na sestavení nabídky, klepněte na tlačítko Sestavení MyFirstVisualizer.Projekt by měl sestavit úspěšně.Před pokračováním opravte všechny chyby sestavení.

Dále je nutné vytvořit spustitelný soubor projektu volat vaše visualizer knihovny DLL.Zjednodušení pomocí projektu aplikace konzoly.

Projekt aplikace konzoly přidat do roztoku

V menu Soubor klikněte na Přidat a potom klikněte na Nový projekt.
V Přidat nový projekt v dialogovém okně pole šablony klepněte na tlačítko Aplikace konzoly.
V název zadejte smysluplný název pro aplikace konzoly, například MyTestConsole.
Klikněte na tlačítko OK.

Nyní je třeba přidat že odkazy nezbytné tak MyTestConsole lze volat MyFirstVisualizer.

Přidání nezbytné odkazy na MyTestConsole

V Aplikaci Solution Explorer, klepněte pravým tlačítkem na MyTestConsolea v místní nabídce klepněte na příkaz Přidat odkaz na.
V Přidat odkaz na v dialogovém okně pole .NET kartu, klepněte na tlačítko Microsoft.VisualStudio.DebuggerVisualizers.
Klikněte na tlačítko OK.
Pravým tlačítkem myši na MyTestConsolea klepněte na tlačítko Přidat odkaz na znovu.
V Přidat odkaz na dialogové okno, klepněte projekty kartu a vyberte MyFirstVisualizer.
Klikněte na tlačítko OK.

Dokončit své testovací vodiče a otestovat vaše Visualizer

Nyní přidáte kód dokončit test kabelového svazku.

Přidání kódu do MyTestConsole

V Aplikaci Solution Explorer, klepněte pravým tlačítkem na Program.vba v místní nabídce klepněte na příkaz Přejmenovat.
Upravte název z Module1.vb na něco vhodné, například TestConsole.vb.

Všimněte si, že Visual Studio automaticky změní deklaraci třídy v TestConsole.vb odpovídající nový název souboru.
V TestConsole.VB, přidejte následující Imports prohlášení:
```
Imports MyFirstVisualizer
```

V metodě Main, přidejte následující kód:

Dim myString As String = "Hello, World"
DebuggerSide.TestShowVisualizer(myString)

Nyní jste připraveni otestovat vaše první visualizer.

Test visualizer

V Aplikaci Solution Explorer, klepněte pravým tlačítkem na MyTestConsolea v místní nabídce klepněte na příkaz nastavit jako spuštění projektu.
Na ladění nabídky, klepněte na tlačítko Start.

Spustí se aplikace konzoly.Zobrazí se visualizer řetězec "Hello, World."

Blahopřejeme.Právě jste vytvořena a testována vaše první visualizer.

Chcete-li použít vaše visualizer v Visual Studio spíše než právě jeho volání z testovací vodiče, nutné jej nainstalovat.Další informace naleznete v tématu Jak: Nainstalujte Visualizer.

Viz také

Sdílet prostřednictvím