Worksheet ホスト項目は、Excel のプライマリ相互運用機能アセンブリからWorksheet型を拡張する型です。 Worksheetホスト項目は、Worksheet オブジェクトと同じプロパティ、メソッド、およびイベントをすべて提供しますが、追加のイベントも公開し、ホスト コントロールと Windows フォーム コントロールのコンテナーとして機能します。
適用対象: このトピックの情報は、Excel のドキュメント レベルのプロジェクトと VSTO アドイン プロジェクトに適用されます。 詳細については、「 Office アプリケーションとプロジェクトの種類で使用できる機能」を参照してください。
ドキュメント レベルのプロジェクトでは、デザイン時 Worksheet ホスト項目をプロジェクトに追加できます。 VSTO アドイン プロジェクトでは、実行時に Worksheet ホスト項目を生成できます。
ドキュメントレベルのプロジェクトにおけるワークシートホスト項目の理解
Excel 用のドキュメント レベルのプロジェクトを作成すると、Visual Studio によってプロジェクトに 3 つの Worksheet ホスト項目が自動的に作成されます。 ワークシートの既定の名前は、 Sheet1、 Sheet2、および Sheet3です。 既存のブックに基づいてプロジェクトを作成する場合、ホスト項目の数はブック内のワークシートの数によって異なります。
これらのワークシート クラスを使用すると、 Worksheet ホスト項目のメンバーにアクセスして、ワークシートの内容の変更などの基本的なタスクをカスタマイズで実行できます。 これらのクラスを使用して、ワークシートにコントロールを追加することもできます。 さまざまなコントロールセットを組み合わせてコードを記述することで、コントロールをデータにバインドし、ユーザーから情報を収集し、ユーザーアクションに応答することができます。 詳細については、「 プログラムのドキュメント レベルのカスタマイズ」を参照してください。
ワークシート クラスは、プロジェクトでコードの記述を開始できる場所を提供します。 クラスには、Excel のプライマリ相互運用機能アセンブリの Worksheet オブジェクトと同じプロパティ、メソッド、およびイベントがすべて用意されているため、これらのクラスを使用して Excel のオブジェクト モデルにアクセスすることもできます。 詳細については、「 Excel オブジェクト モデルの概要」を参照してください。
ドキュメント レベルのプロジェクトでは、デザイン時に新しいワークシートをデザイナーのブックに追加することで、プロジェクトにホスト項目 Worksheet 追加できます。
ワークシートの名前を変更する
ドキュメント レベルのプロジェクトでは、Visual Studio デザイナーでワークシートの名前を変更できますが、変更されるのはワークシートの表示名のみです。 プログラム名は、ワークシートの既定の名前のままです。 [プロパティ] ウィンドウでワークシートの名前を変更すると、プログラム名のみが変更されます。
ドキュメント レベルのプロジェクトでのワークシート ホスト項目の制限事項
ドキュメント レベルのプロジェクトでは、実行時に新しい Worksheet ホスト項目を作成することはできません。 実行時に新しい Excel ワークシートを作成すると、 Worksheetの種類になります。 ホスト項目ではないため、ホスト コントロールまたは Windows フォーム コントロールを含めることはできません。 実行時にドキュメントを作成する方法の詳細については、「 方法: プログラムによって新しいワークシートをブックに追加する」を参照してください。
VSTO アドイン プロジェクトのワークシート ホスト項目を理解することについて
アプリケーション レベルのプロジェクトでは、Excel で開いているワークシートに対して、実行時に Worksheet ホスト項目を生成できます。 Worksheetホスト項目を使用して、関連付けられたワークシートにコントロールを追加したり、Worksheetオブジェクトで使用できないイベントを処理したりできます。
Worksheetホスト項目を生成するには、GetVstoObject メソッドを使用します。 詳細については、「実行時に VSTO アドインで Word 文書と Excel ブックを拡張する」を参照してください。