コントロールとコンポーネントの作成時のトラブルシューティング

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

更新 : 2007 年 11 月

このトピックでは、コンポーネントとコントロールの作成時に発生する次の一般的な問題について説明します。詳細については、「コンポーネントによるプログラミング」を参照してください。

ツールボックスにコントロールを追加できない
Windows フォームのユーザーコントロールまたはコンポーネントをデバッグできない
継承されたコントロールまたはコンポーネントでイベントが 2 回発生する
デザイン時エラー : "コンポーネント 'コンポーネント名' を生成できませんでした。"
STAThreadAttribute
コンポーネントアイコンがツールボックスに表示されない

ツールボックスにコントロールを追加できない

別のプロジェクトで作成したカスタムコントロールまたはサードパーティコントロールをツールボックスに追加する場合は、手動で追加する必要があります。コントロールまたはコンポーネントが現在のプロジェクトに含まれているときは、ツールボックスに自動的に表示されます。詳細については、「チュートリアル : ツールボックスへのカスタムコンポーネントの自動設定」を参照してください。

コントロールをツールボックスに追加するには

[ツールボックス] を右クリックして、ショートカットメニューの [アイテムの選択] をクリックします。
[ツールボックスアイテムの選択] ダイアログボックスで、コンポーネントを追加します。
- .NET Framework コンポーネントまたはコントロールを追加するには、[.NET Framework コンポーネント] タブをクリックします。
  
  または
- COM コンポーネントまたは ActiveX コントロールを追加するには、[COM コンポーネント] タブをクリックします。
ダイアログボックスにコントロールが一覧表示されたら、コントロールが選択されていることを確認して [OK] をクリックします。

コントロールがツールボックスに追加されます。
ダイアログボックスにコントロールが一覧表示されない場合は、次の手順を実行します。
1. [参照] をクリックします。
2. コントロールが入っている .dll ファイルが格納されたフォルダを参照します。
3. .dll ファイルを選択し、[開く] をクリックします。
  
  ダイアログボックスにコントロールが表示されます。
4. コントロールが選択されていることを確認して [OK] をクリックします。
  
  コントロールがツールボックスに追加されます。

Windows フォームのユーザーコントロールまたはコンポーネントをデバッグできない

コントロールが UserControl クラスから派生している場合は、テストコンテナで実行時の動作をデバッグできます。詳細については、「方法 : UserControl の実行時の動作をテストする」を参照してください。

その他のカスタムコントロールやカスタムコンポーネントはスタンドアロンプロジェクトではありません。そのため、Windows フォームプロジェクトなどのアプリケーションでホストする必要があります。コントロールまたはコンポーネントをデバッグするには、Windows フォームプロジェクトに追加する必要があります。

コントロールまたはコンポーネントをデバッグするには

[ビルド] メニューの [ソリューションのビルド] をクリックしてソリューションをビルドします。
[ファイル] メニューで、[追加]、[新しいプロジェクト] の順にクリックして、アプリケーションにテストプロジェクトを追加します。
[新しいプロジェクトの追加] ダイアログボックスで、プロジェクトの種類として [Windows アプリケーション] を選択します。
ソリューションエクスプローラで、新しいプロジェクトの [参照設定] ノードを右クリックします。ショートカットメニューの [参照の追加] をクリックして、コントロールまたはコンポーネントを含むプロジェクトへの参照を追加します。
コントロールまたはコンポーネントのインスタンスをテストプロジェクトに作成します。コンポーネントがツールボックスに表示されている場合は、デザイナ画面にドラッグできます。または、次のコード例に示すように、プログラムによってインスタンスを作成できます。
```
Dim Component1 As New MyNeatComponent()
```
```
MyNeatComponent Component1 = new MyNeatComponent();
```
これで、コントロールまたはコンポーネントを通常の方法でデバッグできるようになります。

デバッグの詳細については、「Visual Studio でのデバッグ」および「チュートリアル : カスタム Windows フォームコントロールのデザイン時のデバッグ」を参照してください。

継承されたコントロールまたはコンポーネントでイベントが 2 回発生する

Handles 句が重複していることが原因と考えられます。詳細については、「Visual Basic での継承されたイベントハンドラのトラブルシューティング」を参照してください。

デザイン時エラー : "コンポーネント 'コンポーネント名' を生成できませんでした。"

コンポーネントやコントロールは、パラメータなしの既定のコンストラクタを提供する必要があります。デザイン環境は、コンポーネントやコントロールのインスタンスを作成するときに、パラメータを受け取るコンストラクタオーバーロードにパラメータを提供しません。

STAThreadAttribute

STAThreadAttribute は、Windows フォームがシングルスレッドアパートメントモデルを使用することを共通言語ランタイム (CLR: Common Language Runtime) に通知します。この属性を Windows フォームアプリケーションの Main メソッドに適用していない場合、意図しない動作が発生する場合があります。たとえば、ListView などのコントロールに背景イメージが表示されない場合があります。また、一部のコントロールでオートコンプリート動作やドラッグアンドドロップ動作を正常に行うためには、この属性が必要になる場合があります。

コンポーネントアイコンがツールボックスに表示されない

ToolboxBitmapAttribute を使用してアイコンをカスタムコンポーネントに関連付けた場合、自動的に生成されたコンポーネントのビットマップがツールボックスに表示されません。ビットマップを表示するには、[ツールボックスアイテムの選択] ダイアログボックスを使用してコントロールを再読み込みします。詳細については、「方法 : コントロールにツールボックスビットマップを指定する」を参照してください。