チュートリアル : カスタム Windows フォームコントロールのデザイン時のデバッグ

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

カスタムコントロールを作成したときは、多くの場合、デザイン時動作のデバッグが必要になります。特にカスタムコントロール用のカスタムデザイナを作成した場合は、このようなデバッグが不可欠です。詳細については、「チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォームコントロールの作成」を参照してください。

カスタムコントロールは、他の .NET Framework クラスの場合と同じように Visual Studio を使用してデバッグできます。ただし、カスタムコントロールの場合は、そのコードを実行する Visual Studio の別個のインスタンスをデバッグするという点が異なります。

このチュートリアルでは、以下のタスクを行います。

カスタムコントロールをホストする Windows フォームプロジェクトの作成
コントロールライブラリプロジェクトの作成
カスタムコントロールへのプロパティの追加
ホストフォームへのカスタムコントロールの追加
デザイン時デバッグのためのプロジェクト設定
カスタムコントロールのデザイン時のデバッグ

ここでは、カスタムコントロールのデザイン時の動作のデバッグに必要なタスクについて理解します。

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

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

プロジェクトの作成

最初にアプリケーションプロジェクトを作成します。このプロジェクトを使用して、カスタムコントロールをホストするアプリケーションをビルドします。

プロジェクトを作成するには

"DebuggingExample" という名前の Windows アプリケーションプロジェクトを作成します。詳細については、「方法 : Windows アプリケーションプロジェクトを作成する」を参照してください。

コントロールライブラリプロジェクトの作成

次に、コントロールライブラリプロジェクトを作成し、カスタムコントロールを設定します。

コントロールライブラリプロジェクトを作成するには

Windows コントロールライブラリプロジェクトをソリューションに追加します。詳細については、「[新しいプロジェクトの追加] ダイアログボックス」を参照してください。このプロジェクトに "DebugControlLibrary" という名前を付けます。
新しい UserControl アイテムを DebugControlLibrary プロジェクトに追加します。詳細については、「方法 : 新しいプロジェクト項目を追加する」を参照してください。新しいソースファイルに、"DebugControl" という基本名を付けます。
ソリューションエクスプローラを使用して、"UserControl1" という基本名のコードファイルを削除することにより、プロジェクトの既定のコントロールを削除します。詳細については、「方法 : 項目を除去、削除、除外する」を参照してください。
ソリューションをビルドします。

チェックポイント

この時点で、カスタムコントロールがツールボックスに表示されます。

進行状況を確認するには

[DebugControlLibrary コンポーネント] という新しいタブを見つけ、クリックして選択します。開いたタブには、コントロールが [DebugControl] としてリストされ、その横に既定のアイコンが表示されます。

カスタムコントロールへのプロパティの追加

カスタムコントロールのコードがデザイン時に動作することを示すために、プロパティを追加し、そのプロパティを実装するコードにブレークポイントを設定します。

カスタムコントロールにプロパティを追加するには

コードエディタで [DebugControl] を開きます。次のコードをクラス定義に追加します。

Private demoStringValue As String = Nothing
<BrowsableAttribute(true)>
Public Property DemoString() As String

    Get
        Return Me.demoStringValue
    End Get

    Set(ByVal value As String)
        Me.demoStringValue = value
    End Set

End Property

private string demoStringValue = null;
[Browsable(true)]
public string DemoString
{
    get
    {
        return this.demoStringValue;
    }
    set
    {
        demoStringValue = value;
    }
}

ソリューションをビルドします。

ホストフォームへのカスタムコントロールの追加

カスタムコントロールのデザイン時動作をデバッグするには、カスタムコントロールクラスのインスタンスをホストフォームに配置します。

ホストフォームにカスタムコントロールを追加するには

"DebuggingExample" プロジェクトの Form1 を Windows フォームデザイナで開きます。
[ツールボックス] の [DebugControlLibrary コンポーネント] タブを開き、[DebugControl] インスタンスをフォームにドラッグします。
[プロパティ] ウィンドウで DemoString カスタムプロパティを見つけます。このプロパティの値は、他のプロパティと同じように変更できます。また、DemoString プロパティを選択すると、[プロパティ] ウィンドウの下部にプロパティの説明文字列が表示されます。

デザイン時デバッグのためのプロジェクト設定

カスタムコントロールのデザイン時動作をデバッグするには、カスタムコントロールのコードを実行する Visual Studio の別個のインスタンスをデバッグします。

デザイン時デバッグのためにプロジェクトを設定するには

ソリューションエクスプローラで、[DebugControlLibrary] プロジェクトを右クリックし、[プロパティ] をクリックします。
DebugControlLibrary プロパティシートの [デバッグ] タブをクリックします。

[開始動作] セクションで、[外部プログラムの開始] を選択します。Visual Studio の別個のインスタンスをデバッグするので、省略記号 () ボタンをクリックして、Visual Studio IDE を参照します。実行可能ファイルの名前は devenv.exe で、既定の場所にインストールした場合、ファイルのパスは "%programfiles%\Microsoft Visual Studio 9.0\Common7\IDE\devenv.exe" になります。
[OK] をクリックし、ダイアログボックスを閉じます。
[DebugControlLibrary] プロジェクトを右クリックし、[スタートアッププロジェクトに設定] をクリックして、このデバッグ構成を有効にします。

カスタムコントロールのデザイン時のデバッグ

これで、カスタムコントロールをデザインモードで実行しながらデバッグする準備ができました。デバッグセッションを開始すると、Visual Studio の新しいインスタンスが作成され、それを使って "DebuggingExample" ソリューションを読み込みます。フォームデザイナで Form1 を開くと、カスタムコントロールのインスタンスが作成され、実行を開始します。

カスタムコントロールをデザイン時にデバッグするには

コードエディタで [DebugControl] ソースファイルを開き、DemoString プロパティの Set アクセサにブレークポイントを配置します。
F5 キーを押してデバッグセッションを開始します。Visual Studio の新しいインスタンスが作成されることを確認してください。各インスタンスは、次の 2 つの方法で識別できます。
- デバッグインスタンスのタイトルバーには、"実行中" という単語が表示されます。
- デバッグインスタンスの [デバッグ] ツールバーの [開始] ボタンは無効になります。
デバッグインスタンスにブレークポイントが設定されます。
Visual Studio の新しいインスタンスで、"DebuggingExample" ソリューションを開きます。[ファイル] メニューの [最近使ったプロジェクト] をクリックすると、ソリューションが簡単に見つかります。"DebuggingExample.sln" ソリューションファイルが、最後に使用したファイルとして表示されます。
フォームデザイナで Form1 を開き、[DebugControl] コントロールを選択します。
DemoString プロパティの値を変更します。変更をコミットすると、Visual Studio のデバッグインスタンスがフォーカスを取得し、ブレークポイントで実行が停止します。プロパティアクセサは、他のコードと同じようにシングルステップ実行できます。
デバッグセッションが終了したら、Visual Studio のホストインスタンスを閉じるか、デバッグインスタンスの [デバッグの停止] をクリックして終了できます。

次の手順

これで、カスタムコントロールをデザイン時にデバッグできるようになりました。この後は、コントロールと Visual Studio IDE の対話をさまざまな方法で拡張できます。

Component クラスの DesignMode プロパティを使用して、デザイン時にのみ動作するコードを記述できます。詳細については、「DesignMode」を参照してください。
カスタムコントロールとデザイナの対話を操作するために、コントロールのプロパティに適用できる属性がいくつかあります。これらの属性は、System.ComponentModel 名前空間に含まれています。
カスタムコントロール用のカスタムデザイナを作成できます。これにより、Visual Studio によって公開されている拡張性のあるデザイナインフラストラクチャを使用して、デザイン手順を全面的に制御できます。詳細については、「チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォームコントロールの作成」を参照してください。

参照

処理手順

チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォームコントロールの作成

方法 : デザイン時サービスにアクセスする

方法 : Windows フォームでデザイン時サポートにアクセスする

次の方法で共有

チュートリアル : カスタム Windows フォームコントロールのデザイン時のデバッグ

プロジェクトの作成

プロジェクトを作成するには

コントロールライブラリプロジェクトの作成

コントロールライブラリプロジェクトを作成するには

チェックポイント

進行状況を確認するには

カスタムコントロールへのプロパティの追加

カスタムコントロールにプロパティを追加するには

ホストフォームへのカスタムコントロールの追加

ホストフォームにカスタムコントロールを追加するには

デザイン時デバッグのためのプロジェクト設定

デザイン時デバッグのためにプロジェクトを設定するには

カスタムコントロールのデザイン時のデバッグ

カスタムコントロールをデザイン時にデバッグするには

次の手順

参照

処理手順

その他のリソース

次の方法で共有

チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ

プロジェクトの作成

プロジェクトを作成するには

コントロール ライブラリ プロジェクトの作成

コントロール ライブラリ プロジェクトを作成するには

チェックポイント

進行状況を確認するには

カスタム コントロールへのプロパティの追加

カスタム コントロールにプロパティを追加するには

ホスト フォームへのカスタム コントロールの追加

ホスト フォームにカスタム コントロールを追加するには

デザイン時デバッグのためのプロジェクト設定

デザイン時デバッグのためにプロジェクトを設定するには

カスタム コントロールのデザイン時のデバッグ

カスタム コントロールをデザイン時にデバッグするには

次の手順

参照

処理手順

その他のリソース

チュートリアル : カスタム Windows フォームコントロールのデザイン時のデバッグ

コントロールライブラリプロジェクトの作成

コントロールライブラリプロジェクトを作成するには

カスタムコントロールへのプロパティの追加

カスタムコントロールにプロパティを追加するには

ホストフォームへのカスタムコントロールの追加

ホストフォームにカスタムコントロールを追加するには

カスタムコントロールのデザイン時のデバッグ

カスタムコントロールをデザイン時にデバッグするには