Návod: Zápis vizualizéru v jazyce Visual Basic

Článek
06/10/2015

Tento návod ukazuje, jak zapisovat pomocí jednoduchého visualizer Visual Basic.Visualizer, které vytvoříte v tomto návodu zobrazí obsah řetězce pomocí zprávou model Windows Forms.Tento jednoduchý řetězec visualizer je základní příklad chcete-li 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 vaše nastavení, přejděte Nástroje nabídky a zvolte Import a Export .Další informace naleznete v tématu Přizpůsobení nastavení pro vývoj v sadě Visual Studio.

Visualizer kód musí být umístěn v knihovně DLL, která bude číst ladicím programem.Prvním krokem je vytvoření projektu knihovny třídy z knihovny DLL.

Vytvořit a příprava projektu knihovny tříd

Vytvoření projektu knihovny tříd

Na souboru nabídky, zvolte nové a klepněte na tlačítko Nový projekt.
V Nový projekt dialogovém okně vyberte v seznamu Typu projektus, klepněte na tlačítko jazyka Visual Basic.
V šablony klepněte na tlačítko Knihovny tříd.
Do pole Název napište příslušný název knihovny tříd jako je například MyFirstVisualizer.
Klikněte na tlačítko OK.

Po vytvoření knihovny tříd, je nutné přidat odkaz na Microsoft.VisualStudio.DebuggerVisualizers.DLL, takže můžete použít třídy definované tam.Nejprve však dáte projektu smysluplný název.

Přejmenovat Class1.vb a přidat Microsoft.VisualStudio.DebuggerVisualizers

V Průzkumník řešení, klepněte pravým tlačítkem myši Class1.vba v místní nabídce klepněte na příkaz Přejmenovat.
Změňte název v Class1.vb na určité akce, například DebuggerSide.vb.

[!POZNÁMKA]

Visual Studiodeklarace třídy v DebuggerSide.vb tak, aby odpovídala názvu nového souboru se automaticky změní.
V Průzkumník řešení, klepněte pravým tlačítkem myši Moje první Visualizera v místní nabídce klepněte na příkaz Přidat odkaz.
V Přidat odkaz dialogové okno, v .NET karta, 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řidejte kód pro stranu ladicí program

Nyní jste připraveni vytvořit kód pro stranu ladicí program.Toto je kód, který je spouštěn v rámci ladicího programu pro zobrazení informace, kterou je potřeba vizualizovat.Nejprve je nutné změnit prohlášení o DebuggerSide objektu tak, aby se dědí ze základní třídy DialogDebuggerVisualizer.

Dědění z DialogDebuggerVisualizer

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

Upravte kód tak, aby vypadá takto:

Public Class DebuggerSide
Inherits DialogDebuggerVisualizer

DialogDebuggerVisualizermá jeden abstraktní metoda, Show, který je třeba přepsat.

Přepsání 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ě vytvoří dialogové okno visualizer nebo jiných prvků uživatelského rozhraní a zobrazí informace, které byl předán visualizer z ladicího programu.Je zapotřebí napsat kód, který vytvoří dialogové okno a zobrazí informaci.V tomto návodu je to použití model Windows Forms zprávou.Nejprve musíte přidat odkaz a Imports prohlášení pro System.Windows.Forms.

Přidání System.Windows.Forms

V Průzkumník řešení, klepněte pravým tlačítkem myši odkazya v místní nabídce klepněte na příkaz Přidat odkaz.
V Přidat odkaz dialogové okno, v .NET karta, klepněte na tlačítko System.Windows.Forms.
Klikněte na tlačítko OK.
Ve třídě DebuggerSide.cs přidejte do příkazů Imports následující příkaz:
```
Imports System.Windows.Forms
```

Vytvoření vaše Visualizer uživatelského rozhraní

Nyní přidáte kód k vytvoření a zobrazení uživatelského rozhraní pro vaše visualizer.Vzhledem k tomu, že je to vaše první visualizer, budou vést jednoduché uživatelské rozhraní a použít okno se zprávou.

Chcete-li zobrazit visualizer výstup v dialogovém okně

Do metody Show přidejte následující řádek kódu:
```
MessageBox.Show(objectProvider.GetObject().ToString())
```
V tomto příkladu není zahrnuto zpracování chyb.Měli byste zahrnout zpracování chyb v reálné visualizer nebo jakékoli jiné aplikace.
Na sestavení nabídky, klepněte na tlačítko Sestavení MyFirstVisualizer.Sestavení projektu by mělo být úspěšně dokončeno.Před pokračováním opravte všechny chyby při sestavení.

Přidejte atribut nezbytné

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

Chcete-li přidat kód straně debugee

Přidejte následující kód atributu DebuggerSide.vb, po Imports výpisy ale předtím, než 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.Sestavení projektu by mělo být úspěšně dokončeno.Před pokračováním opravte všechny chyby při sestavení.

Vytvořit testovací nástroje

V této chvíli je první vizualizér dokončen.Pokud jste následovali kroky správně, můžete vizualizér sestavit a nainstalovat jej do Visual Studio.Avšak před instalací vizualizéru do Visual Studio je zapotřebí jej otestovat a ujistit se, zda pracuje správně.Nyní vytvoříte správce testů pro spuštění vizualizéru aniž by byl nainstalován do Visual Studio.

Chcete-li přidat zkušební metoda, chcete-li zobrazit visualizer

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

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.Sestavení projektu by mělo být úspěšně dokončeno.Před pokračováním opravte všechny chyby při sestavení.

V dalším kroku je nutné vytvořit spustitelný projekt pro zavolání knihovny DLL vizualizéru.Pro zjednodušení použijte projekt konzolové aplikace.

Do řešení přidejte nový projekt konzolové aplikace s názvem .

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

Nyní je zapotřebí přidat nezbytné reference, aby mohl MyTestConsole zavolat MyFirstVisualizer.

Přidání nezbytných referencí na MyTestConsole

V Průzkumník řešení, klepněte pravým tlačítkem myši MyTestConsolea v místní nabídce klepněte na příkaz Přidat odkaz.
V Přidat odkaz dialogové okno, v .NET karta, klepněte na tlačítko Microsoft.VisualStudio.DebuggerVisualizers.
Klikněte na tlačítko OK.
Klepněte pravým tlačítkem myši MyTestConsolea potom klepněte na tlačítko Přidat odkaz znovu.
V Přidat odkaz dialogové okno, klepněte projekty kartu a pak vyberte MyFirstVisualizer.
Klikněte na tlačítko OK.

Dokončit testovací nástroje a otestovat vaše Visualizer.

Nyní budete přidávat kód pro dokončené správce testů.

Přidání kódu do MyTestConsole

V Průzkumník řešení, klepněte pravým tlačítkem myši soubor Program.vba v místní nabídce klepněte na příkaz Přejmenovat.
Upravte název z Module1.vb něco vhodné, například TestConsole.vb.

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

Do metody Main přidejte následující kód:

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

Nyní jste připraveni k testování vaší první visualizer.

Otestování vizualizéru

V Průzkumník řešení, klepněte pravým tlačítkem myši MyTestConsolea v místní nabídce klepněte na příkaz nastavit jako projekt při spuštění.
Na ladění nabídky, klepněte na tlačítko Start.

Spuštění aplikace konzoly.Visualizer zobrazí se řetězec "Hello, World."

Gratulujeme!Právě jste sestavili a otestovali první vizualizér.

Pokud byste raději používali vizualizér v rámci Visual Studio, než ho volali skrz správce testů, musíte jej nainstalovat.Další informace naleznete v tématu Postupy: Instalace vizualizéru.

Viz také

Sdílet prostřednictvím