Sdílet prostřednictvím

Názorný postup: Zápis v jazyce C# Visualizer

  • Článek

Tento názorný postup ukazuje, jak napsat jednoduchou visualizer pomocí jazyka C#.Visualizer, které vytvoříte v tomto návodu zobrazí obsah řetězce pomocí Windows forms zprávou.Tento jednoduchý řetězec visualizer není užitečná samo, ale ukazuje základní kroky, které musí následovat visualizers užitečnější pro jiné typy dat vytvořit.

[!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 nastavení.Další informace naleznete v tématu Nastavení aplikace Visual Studio.

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

Vytvoření projektu knihovny tříd

  1. Na soubor nabídce zvolte Nový a klepněte na tlačítko Nový projekt.

  2. V Nový projekt dialogovém okně vyberte v seznamu Typ projektus, vyberte Visual C#.

  3. V šablony pole, zvolte Knihovna tříd.

  4. V název zadejte vhodný název knihovny třídy, například MyFirstVisualizer.

  5. Klikněte na tlačítko OK.

Po vytvoření knihovny třídy je nutné přidat odkaz na Microsoft.VisualStudio.DebuggerVisualizers.DLL tak, aby tam pomocí definovaných tříd.Před přidáním odkazu však musíte přejmenovat některé třídy tak, aby smysluplné názvy.

Přejmenovat MultiThreadApplication a přidat Microsoft.VisualStudio.DebuggerVisualizers

  1. V Aplikaci Solution Explorer, File klepněte pravým tlačítkem a zvolte Přejmenovat v místní nabídce.

  2. Změňte název MultiThreadApplication z smysluplné, například DebuggerSide.cs.

    [!POZNÁMKA]

    Visual Studiodeklarace třídy v DebuggerSide.cs odpovídající nový název souboru se automaticky změní.

  3. V Aplikaci Solution Explorer, klepněte pravým tlačítkem na odkazy a zvolte Přidat odkaz na v místní nabídce.

  4. V Přidat odkaz na v dialogovém okně pole .NET Microsoft.VisualStudio.DebuggerVisualizers.DLL vyberte.

  5. Klikněte na tlačítko OK.

  6. V DebuggerSide.cs, přidejte následující příkaz using příkazy:

    using Microsoft.VisualStudio.DebuggerVisualizers;

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 objektu, který dědí ze základní třídy DialogDebuggerVisualizer.

Z DialogDebuggerVisualizer

  1. V DebuggerSide.cs přejděte na následující řádek kódu:

    public class DebuggerSide

  2. Změna kódu:

    public class DebuggerSide : DialogDebuggerVisualizer

DialogDebuggerVisualizermá jeden abstraktní metodu (Show), musíte změnit.

Potlačení metody DialogDebuggerVisualizer.Show

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

    override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
{
}

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í formuláře zprávou systému Windows.Nejprve musíte přidat odkaz a using prohlášení bylo povoleno.

Aby bylo povoleno přidat

  1. V Aplikaci Solution Explorer, klepněte pravým tlačítkem na odkazy a zvolte Přidat odkaz na v místní nabídce.

  2. V Přidat odkaz na v dialogovém okně pole .NET System.Windows.Forms.DLL vyberte.

  3. Klikněte na tlačítko OK.

  4. V DebuggerSide.cs, přidejte následující příkaz using příkazy:

    using System.Windows.Forms;

Nyní přidáte kód vytvořit a zobrazit uživatelské rozhraní pro vaše visualizer.Toto je vaše první visualizer, jsme ponechá jednoduché uživatelské rozhraní a okno se zprávou.

V dialogovém okně zobrazit výstup Visualizer

  1. 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.

  2. Na sestavení nabídce zvolte Sestavení MyFirstVisualizer.Projekt by měl sestavit úspěšně.Před pokračováním opravte všechny chyby sestavení.

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

Přidat kód na straně debuggee

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

    [assembly:System.Diagnostics.DebuggerVisualizer(
typeof(MyFirstVisualizer.DebuggerSide),
typeof(VisualizerObjectSource),
Target  = typeof(System.String),
Description  = "My First Visualizer")]

  2. Na sestavení nabídce zvolte Sestavení MyFirstVisualizer.Projekt by měl sestavit úspěšně.Před pokračováním opravte všechny chyby sestavení.

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

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

    public static void TestShowVisualizer(object objectToVisualize)
{
   VisualizerDevelopmentHost visualizerHost = new VisualizerDevelopmentHost(objectToVisualize, typeof(DebuggerSide));
   visualizerHost.ShowVisualizer();
}

  2. Na sestavení nabídce zvolte 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.Pro jednoduchost použijeme konzolové aplikace project.

Projekt aplikace konzoly přidat do roztoku

  1. Na soubor nabídce zvolte Přidat a klepněte na tlačítko Nový projekt.

  2. V Přidat nový projekt v dialogovém okně pole šablony pole, zvolte Aplikace konzoly.

  3. V název například zadejte smysluplný název pro aplikace konzoly MyTestConsole.

  4. 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

  1. V Aplikaci Solution Explorer, klepněte pravým tlačítkem na MyTestConsole a zvolte Přidat odkaz na v místní nabídce.

  2. V Přidat odkaz na dialogové okno .NET Microsoft.VisualStudio.DebuggerVisualizers.DLL vyberte.

  3. Klikněte na tlačítko OK.

  4. Pravým tlačítkem myši na MyTestConsole a zvolte Přidat odkaz na znovu.

  5. V Přidat odkaz na dialogové okno, klepněte projekty kartu a potom klepněte na tlačítko MyFirstVisualizer.

  6. Klikněte na tlačítko OK.

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

Přidání kódu do MyTestConsole

  1. V Aplikaci Solution Explorer, Program.cs tlačítkem a zvolte Přejmenovat v místní nabídce.

  2. Upravte název z Program.cs na smysluplnější, například TestConsole.cs.

    Poznámka:   Visual Studiodeklarace třídy v TestConsole.cs odpovídající nový název souboru se automaticky změní.

  3. V TestConsole.cs, přidejte následující kód using příkazy:

    using MyFirstVisualizer;

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

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

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

Test visualizer

  1. V Aplikaci Solution Explorer, klepněte pravým tlačítkem na MyTestConsole a zvolte nastavit spuštění projektu jako v místní nabídce.

  2. Na ladění nabídce zvolte Start.

    Aplikace konzoly spustí a 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.

Pomocí šablony položky Visualizer

Tento návod má, zobrazeny jak visualizer vytvořit ručně.Důvodem bylo jako cvičení učení.Nyní, když víte, jak funguje jednoduché visualizer, je jednodušší vytvořit: pomocí šablony visualizer zboží.

Nejprve musíte vytvořit nový projekt knihovny tříd.

Vytvořit novou knihovnu tříd

  1. Na soubor nabídce zvolte Přidat a klepněte na tlačítko Nový projekt.

  2. V Přidat nový projekt dialogovém okně vyberte v seznamu Typ projektus, vyberte Visual C#.

  3. V šablony pole, zvolte Knihovna tříd.

  4. V název zadejte vhodný název knihovny třídy, například MySecondVisualizer.

  5. Klikněte na tlačítko OK.

Nyní můžete přidat položky visualizer na něj:

Přidání položky visualizer

  1. V Aplikaci Solution Explorer, MySecondVisualizer tlačítkem.

  2. V místní nabídce zvolte Přidat a klepněte na tlačítko Nové položky.

  3. V Přidat novou položku dialogovém okně vyberte v seznamu šablony, Visual Studio nainstalované šablony, vyberte Debugger Visualizer.

  4. V název zadejte vhodný název, například SecondVisualizer.cs.

  5. Klikněte na tlačítko Přidat.

To je vše není.Soubor SecondVisualizer.cs a zobrazení Kód, který přidány šablony.Pokračujte a experimentovat s kódem.Nyní, když jste obeznámeni se základy, jsou na váš způsob vytváření složitých a užitečné visualizers vlastní.

Viz také

Úkoly

Jak: Nainstalujte Visualizer

Koncepty

Visualizer architektura

Další zdroje

Visualizers