Workbook ホスト項目は、Excel のプライマリ相互運用機能アセンブリからWorkbook型を拡張する型です。 Workbook ホスト項目には、Workbook オブジェクトと同じプロパティ、メソッド、およびイベントがすべて用意されていますが、追加の機能も提供されます。
適用対象: このトピックの情報は、Excel のドキュメント レベルのプロジェクトと VSTO アドイン プロジェクトに適用されます。 詳細については、「 Office アプリケーションとプロジェクトの種類で使用できる機能」を参照してください。
ドキュメント レベルのプロジェクトでは、プロジェクト内のブックを表す既定の Workbook ホスト項目があります。 VSTO アドイン プロジェクトでは、実行時に Workbook ホスト項目を生成できます。
ドキュメント レベルのプロジェクトでのワークブック ホスト アイテムを理解する
プロジェクト内のブックにアクセスするには、 ThisWorkbook クラスを使用します。
ThisWorkbook クラスを使用すると、Workbook ホスト項目のメンバーにアクセスして、ブックを開いたり閉じたりするときにコードを実行するなど、カスタマイズで基本的なタスクを実行できます。 詳細については、「 プログラムのドキュメント レベルのカスタマイズ」を参照してください。
ThisWorkbook クラスは、プロジェクトでコードの記述を開始できる場所を提供します。 このクラスは、Excel のプライマリ相互運用機能アセンブリの Workbook オブジェクトと同じプロパティ、メソッド、およびイベントをすべて提供するため、 ThisWorkbook を使用して Excel のオブジェクト モデルにアクセスすることもできます。 詳細については、「 Excel オブジェクト モデルの概要」を参照してください。
ソリューション エクスプローラーで ThisWorkbook プロジェクト項目をダブルクリックすると、ブック デザイナーが表示され、[プロパティ] ウィンドウにブックのプロパティとイベントが表示されます。
ドキュメント レベルのプロジェクトにおけるワークブックホストアイテムの制約事項
ドキュメント レベルのプロジェクトには、 Workbook ホスト項目 (つまり、 ThisWorkbook クラス) を 1 つだけ含めることができます。 デザイン時に新しい Workbook ホスト項目をプロジェクトに追加することはできません。また、ドキュメント レベルのカスタマイズから実行時に新しい Workbook ホスト項目を作成することはできません。
実行時に新しい Excel ブックを作成すると、 Workbookの種類になります。 ホスト項目ではないため、ホスト コントロールまたは Windows フォーム コントロールを含めることはできません。 実行時にブックを作成する方法の詳細については、「 方法: プログラムによって新しいブックを作成する」を参照してください。
Workbook ホスト項目は、ホスト コントロールのコンテナーとして機能しません。 そのため、ブックに表示されるコントロールを追加することはできませんが、 DataSetなどのコンポーネントを追加して、すべてのワークシートでコンポーネントを共有できます。 ドキュメント レベルのプロジェクトでは、ブックで使用できるコンポーネントは、[ツールボックス] の [コンポーネント] タブ、[データ] タブ、および [すべての Windows フォーム] タブにあります。
注
Visual Studio の Office 開発ツールは、共有ブックをサポートしていません。
VSTO アドイン プロジェクトのワークブック ホスト項目を理解する
VSTO アドイン プロジェクトでは、Excel で開いているブックに対して、実行時に Workbook ホスト項目を生成できます。
Workbookホスト項目を生成するには、GetVstoObject メソッドを使用します。 詳細については、「実行時に VSTO アドインで Word 文書と Excel ブックを拡張する」を参照してください。