Worksheet ホスト項目

[アーティクル]
02/21/2013

Worksheet ホスト項目は、Excel のプライマリ相互運用機能アセンブリの Microsoft.Office.Interop.Excel.Worksheet 型を拡張する型です。Worksheet ホスト項目は Microsoft.Office.Interop.Excel.Worksheet オブジェクトと同一のプロパティ、メソッド、およびイベントをすべて提供します。また、追加のイベントも公開し、ホストコントロールおよび Windows フォームコントロールのコンテナーとしても機能します。

対象: このトピックの情報は、Excel 2013 と Excel 2010 のドキュメントレベルのプロジェクトおよびアプリケーションレベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクトタイプ別の使用可能な機能」を参照してください。

ドキュメントレベルのプロジェクトでは、デザイン時に Worksheet ホスト項目をプロジェクトに追加できます。アプリケーションレベルのプロジェクトでは、実行時に Worksheet ホスト項目を生成できます。

ドキュメントレベルのプロジェクトでのワークシートのホスト項目について

Excel のドキュメントレベルのプロジェクトを作成すると、Visual Studio によって 3 つの Worksheet ホスト項目がプロジェクト内に自動的に作成されます。これらのワークシートの既定の名前は、Sheet1、Sheet2、および Sheet3 です。既存のブックに基づいてプロジェクトを作成する場合は、そのブック内のワークシートの数に応じてホスト項目の数が決まります。

これらのワークシートクラスによって、Worksheet ホスト項目のメンバーにアクセスし、ワークシートのコンテンツを変更するなど、カスタマイズの基本的なタスクを実行できます。また、ワークシートにコントロールを追加するには、これらのクラスを使用できます。さまざまな種類のコントロールを組み合わせ、コードを記述することによって、コントロールのデータへのバインド、ユーザー情報の収集、およびユーザーの操作への応答を実行できます。詳細については、「ドキュメントレベルのカスタマイズのプログラミング」を参照してください。

ワークシートクラスには、プロジェクトでコードの記述を開始できる場所が用意されています。このクラスには、Excel のプライマリ相互運用機能アセンブリの Microsoft.Office.Interop.Excel.Worksheet オブジェクトと同じプロパティ、メソッド、およびイベントがすべて用意されているため、これらのクラスを使用して Excel のオブジェクトモデルにアクセスすることもできます。詳細については、「Excel オブジェクトモデルの概要」を参照してください。

ドキュメントレベルのプロジェクトの場合は、デザイナーで新しいワークシートをブックに追加することにより、デザイン時に追加の Worksheet ホスト項目をプロジェクトに追加できます。

ワークシートの名前変更

ドキュメントレベルのプロジェクトでは、Visual Studio デザイナーでワークシートの名前を変更できますが、この場合はワークシートの表示名だけが変わります。ワークシートのプログラム上の名前は既定の名前のままです。[プロパティ] ウィンドウでワークシートの名前を変更すると、プログラム上の名前だけが変更されます。

ドキュメントレベルのプロジェクトでのワークシートのホスト項目の制限

ドキュメントレベルのプロジェクトでは、実行時に新しい Worksheet ホスト項目を作成することはできません。実行時に新しい Excel ワークシートを作成すると、そのワークシートは Microsoft.Office.Interop.Excel.Worksheet 型になります。これはホスト項目ではないため、ホストコントロールや Windows フォームコントロールを含めることはできません。実行時に文書を作成する方法の詳細については、「方法: プログラムを使用して新しいワークシートをブックに追加する」を参照してください。

アプリケーションレベルのプロジェクトでのワークシートのホスト項目について

アプリケーションレベルのプロジェクトでは、Excel で開いている任意のワークシートの Worksheet ホスト項目を実行時に生成できます。関連付けられたワークシートにコントロールを追加するに Worksheet のホスト項目を使用して、あるイベントを処理する Microsoft.Office.Interop.Excel.Worksheet で使用できないを追加します。

Worksheet ホスト項目を生成するには、GetVstoObject メソッドを使用します。詳細については、「アプリケーションレベルのアドインにおける実行時の Word 文書や Excel ブックの拡張」を参照してください。