次の方法で共有

チュートリアル : Visual Basic でビジュアライザーを記述する

  • [アーティクル]

このチュートリアルでは、Visual Basic を使用して簡単なビジュアライザーを作成する方法を説明します。このチュートリアルで作成するビジュアライザーは、Windows フォーム メッセージ ボックスを使用して文字列の内容を表示します。この単純な文字列のビジュアライザーは基本的な例で、プロジェクトに合わせて他のデータ型向けのビジュアライザーを作成するときに参考になります。

[!メモ]

使用している設定またはエディションによっては、ヘルプの記載と異なるダイアログ ボックスやメニュー コマンドが表示される場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

ビジュアライザー コードは、デバッガーによって読み取られる DLL に配置する必要があります。最初の手順として、DLL のクラス ライブラリ プロジェクトを作成します。

クラス ライブラリ プロジェクトの作成と準備

クラス ライブラリ プロジェクトを作成するには

  1. [ファイル] メニューの [新規作成] をポイントし、[新しいプロジェクト] をクリックします。

  2. [新しいプロジェクト] ダイアログ ボックスの [プロジェクトの種類] で、[Visual Basic] をクリックします。

  3. [テンプレート] ボックスで、[クラス ライブラリ] をクリックします。

  4. [プロジェクト名] ボックスに、クラス ライブラリの名前 (MyFirstVisualizer など) を入力します。

  5. [OK] をクリックします。

クラス ライブラリを作成したら、Microsoft.VisualStudio.DebuggerVisualizers.DLL への参照を追加することによって、この DLL で定義されているクラスを使用できるようにします。ただし、最初にプロジェクトにわかりやすい名前を付けます。

Class1.vb の名前を変更して Microsoft.VisualStudio.DebuggerVisualizers に追加するには

  1. ソリューション エクスプローラーで Class1.vb を右クリックし、ショートカット メニューの [名前の変更] をクリックします。

  2. Class1.vb の名前を、DebuggerSide.vb などのわかりやすい名前に変更します。

    [!メモ]

    Visual Studio によって、新しいファイル名に合わせて DebuggerSide.vb のクラス宣言が自動的に変更されます。

  3. ソリューション エクスプローラーで、[My First Visualizer] を右クリックし、ショートカット メニューの [参照の追加] をクリックします。

  4. [参照の追加] ダイアログ ボックスの [.NET] タブで、Microsoft.VisualStudio.DebuggerVisualizers.DLL をクリックします。

  5. [OK] をクリックします。

  6. DebuggerSide.vb の Imports ステートメントに次のステートメントを追加します。

    Imports Microsoft.VisualStudio.DebuggerVisualizers

デバッガー側のコードの追加

これで、デバッガー側のコードを作成する準備が整いました。これは、視覚化を要する情報を表示するためにデバッガー内で実行されるコードです。最初に、DebuggerSide オブジェクトの宣言を変更して、DialogDebuggerVisualizer 基本クラスを継承するようにする必要があります。

DialogDebuggerVisualizer から継承するには

  1. DebuggerSide.vb で、次のコード行に移動します。

    Public Class DebuggerSide

  2. 次のようにコードを編集します。

    Public Class DebuggerSide
Inherits DialogDebuggerVisualizer

DialogDebuggerVisualizer には、オーバーライドする必要がある抽象メソッドが 1 つ (Show) あります。

DialogDebuggerVisualizer.Show メソッドをオーバーライドするには

  • public class DebuggerSide に、次のメソッドを追加します。

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

    End Sub

Show メソッドには、ビジュアライザーのダイアログ ボックス、または他のユーザー インターフェイスを実際に作成し、デバッガーからビジュアライザーに渡された情報を表示するコードを記述します。したがって、このダイアログ ボックスを作成し、情報を表示するコードを追加する必要があります。このチュートリアルでは、Windows フォーム メッセージ ボックスを使用します。最初に、System.Windows.Forms の参照と Imports ステートメントを追加する必要があります。

System.Windows.Forms を追加するには

  1. ソリューション エクスプローラーで、[参照設定] を右クリックし、ショートカット メニューの [参照の追加] をクリックします。

  2. [参照の追加] ダイアログ ボックスの [.NET] タブで、System.Windows.Forms をクリックします。

  3. [OK] をクリックします。

  4. DebuggerSide.cs の Imports ステートメントに次のステートメントを追加します。

    Imports System.Windows.Forms

ビジュアライザーのユーザー インターフェイスの作成

次に、ビジュアライザーのユーザー インターフェイスを作成および表示するためのコードを追加します。初めて作成するビジュアライザーであるため、ユーザー インターフェイスを簡素にし、メッセージ ボックスを使用します。

ビジュアライザーの出力をダイアログ ボックスに表示するには

  1. Show メソッドに次のコード行を追加します。

    MessageBox.Show(objectProvider.GetObject().ToString())

    このコード例には、エラー処理が含まれていません。実際に使用するビジュアライザーなど、どのようなアプリケーションにも、エラー処理を追加する必要があります。

  2. [ビルド] メニューの [MyFirstVisualizer のビルド] をクリックします。プロジェクトが構築されます。ビルド エラーを修正してから次の作業に進みます。

必要な属性の追加

これで、デバッガー側のコードは終わりです。ただし、もう 1 つ追加するものがあります。それは、ビジュアライザーを構成しているクラスのコレクションをデバッグ対象側に通知する属性です。

デバッギ側のコードを追加するには

  1. DebuggerSide.vb の Imports ステートメントと namespace MyFirstVisualizer の間に次の属性コードを追加します。

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

  2. [ビルド] メニューの [MyFirstVisualizer のビルド] をクリックします。プロジェクトが構築されます。ビルド エラーを修正してから次の作業に進みます。

テスト ハーネスの作成

これで、最初のビジュアライザーが完成しました。手順どおりに作業を行ってきた場合は、ビジュアライザーを構築し、Visual Studio にインストールできます。ただし、ビジュアライザーを Visual Studio にインストールする前にテストを行い、ビジュアライザーが正しく動作することを確認する必要があります。そこで、Visual Studio にインストールしないでビジュアライザーを実行する、テスト ハーネスを作成します。

ビジュアライザーを表示するテスト メソッドを追加するには

  1. 次のメソッドを public DebuggerSide クラスに追加します。

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

  2. [ビルド] メニューの [MyFirstVisualizer のビルド] をクリックします。プロジェクトが構築されます。ビルド エラーを修正してから次の作業に進みます。

次に、ビジュアライザー DLL を呼び出す実行可能プロジェクトを作成する必要があります。簡易にするために、コンソール アプリケーション プロジェクトを使用します。

ソリューションにコンソール アプリケーション プロジェクトを追加するには

  1. [ファイル] メニューの [追加] をポイントし、[新しいプロジェクト] をクリックします。

  2. [新しいプロジェクト] ダイアログ ボックスの [テンプレート] ボックスで、[コンソール アプリケーション] をクリックします。

  3. [名前] ボックスに、コンソール アプリケーション用のわかりやすい名前 (MyTestConsole など) を入力します。

  4. [OK] をクリックします。

次に、必要な参照を追加して、MyTestConsole が MyFirstVisualizer を呼び出すことができるようにします。

必要な参照を MyTestConsole に追加するには

  1. ソリューション エクスプローラーで、[MyTestConsole] を右クリックし、ショートカット メニューの [参照の追加] をクリックします。

  2. [参照の追加] ダイアログ ボックスの [.NET] タブで、Microsoft.VisualStudio.DebuggerVisualizers をクリックします。

  3. [OK] をクリックします。

  4. [MyTestConsole] を右クリックし、再度 [参照の追加] をクリックします。

  5. [参照の追加] ダイアログ ボックスの [プロジェクト] タブをクリックし、MyFirstVisualizer をクリックします。

  6. [OK] をクリックします。

テスト ハーネスの終了とビジュアライザーのテスト

次に、コードを追加してテスト ハーネスを完成させます。

コードを MyTestConsole に追加するには

  1. ソリューション エクスプローラーで Program.vb を右クリックし、ショートカット メニューの [名前の変更] をクリックします。

  2. Module1.vb の名前を、TestConsole.vb などの適切な名前に変更します。

    Visual Studio によって、新しいファイル名に合わせて TestConsole.vb のクラス宣言が自動的に変更されることに注意してください。

  3. TestConsole.vb で、次の Imports ステートメントを追加します。

    Imports MyFirstVisualizer

  4. Main メソッドに、次のコードを追加します。

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

これで、作成したビジュアライザーをテストする準備が整いました。

ビジュアライザーをテストするには

  1. ソリューション エクスプローラーで MyTestConsole を右クリックし、ショートカット メニューの [スタートアップ プロジェクトに設定] をクリックします。

  2. [デバッグ] メニューの [開始] をクリックします。

    コンソール アプリケーションが起動します。ビジュアライザーが表示され、「Hello, World」という文字列が表示されます。

テストは成功です。これで、最初のビジュアライザーの作成とテストが完了しました。

作成したビジュアライザーをテスト ハーネスから呼び出すのではなく、Visual Studio で使用する場合は、ビジュアライザーをインストールする必要があります。詳細については、「方法 : ビジュアライザーをインストールする」を参照してください。

参照

処理手順

方法 : ビジュアライザーをインストールする

概念

ビジュアライザーのアーキテクチャ

その他の技術情報

ビジュアライザー