Office ソリューションでコードを記述する

Office プロジェクトでのコードの記述には、Visual Studio の他の種類のプロジェクトとは異なるいくつかの側面があります。 これらの違いの多くは、Office オブジェクト モデルがマネージド コードに公開される方法に関連しています。 その他の違いは、Office プロジェクトの設計に関連しています。

適用対象: このトピックの情報は、ドキュメント レベルのプロジェクトと VSTO アドイン プロジェクトに適用されます。 「Office アプリケーションとプロジェクトの種類で使用できる機能」を参照してください。

マネージド コードと Office プログラミング

統合された Microsoft Office ソリューションの作成を可能にする主なテクノロジは、コンポーネント オブジェクト モデル (COM) テクノロジの一部である Automation です。 オートメーションを使用すると、コードを使用して、適切なプログラム インターフェイスをサポートする任意のアプリケーション、DLL、または ActiveX コントロールによって公開されるソフトウェア オブジェクトを作成および制御できます。

プライマリ相互運用アセンブリを理解する

Microsoft Office アプリケーションは、その機能の多くを Automation に公開します。 ただし、マネージド コード (Visual Basic や C#など) を直接使用して Office アプリケーションを自動化することはできません。 マネージド コードを使用して Office アプリケーションを自動化するには、Office プライマリ相互運用機能アセンブリ (PIA) を使用する必要があります。 プライマリ相互運用機能アセンブリを使用すると、マネージド コードで Office アプリケーションの COM ベースのオブジェクト モデルを操作できます。

すべての Microsoft Office アプリケーションには PIA があります。 Visual Studio で Office プロジェクトを作成すると、適切な PIA への参照がプロジェクトに自動的に追加されます。 プロジェクトから他の Office アプリケーションの機能を自動化するには、適切な PIA への参照を手動で追加する必要があります。 詳細については、「 方法: プライマリ相互運用機能アセンブリを使用して Office アプリケーションをターゲットにする」を参照してください。

設計時と実行時にプライマリ相互運用機能アセンブリを使用する

ほとんどの開発タスクを実行するには、開発用コンピューターのグローバル アセンブリ キャッシュに Office PIA がインストールされ、登録されている必要があります。 詳細については、「 Office ソリューションを開発するためのコンピューターの構成」を参照してください。

.NET Framework 4 以降を対象とする Office ソリューションを実行するために、エンド ユーザー コンピューターでは Office PIA は必要ありません。 詳細については、「 Office ソリューションの設計と作成」を参照してください。

プライマリ相互運用機能アセンブリで型を使用する

Office PIA には、Office アプリケーションのオブジェクト モデルを公開する型と、コードで直接使用することを意図していない追加のインフラストラクチャ型の組み合わせが含まれています。 Office PIA の型の概要については、「Office プライマリ相互運用機能アセンブリのクラスとインターフェイスの概要」を参照してください。

Office PIA の型は COM ベースのオブジェクト モデルの型に対応するため、多くの場合、これらの型の使用方法は他のマネージド型とは異なります。 たとえば、Office プライマリ相互運用機能アセンブリで省略可能なパラメーターを持つメソッドを呼び出す方法は、プロジェクトで使用しているプログラミング言語によって異なります。 詳細については、次のトピックを参照してください。

• Office ソリューションの省略可能なパラメーター。

• Office ソリューションでのレイト バインディング。

Office プロジェクトのプログラム モデル

すべての Office プロジェクトには、コードのエントリ ポイントを提供する 1 つ以上の生成されたクラスが含まれています。 これらのクラスは、ホスト アプリケーションのオブジェクト モデルへのアクセスや、操作ウィンドウやカスタム作業ウィンドウなどの機能へのアクセスも提供します。

生成されたクラスを理解する

Excel および Word のドキュメント レベルのプロジェクトでは、生成されたクラスはアプリケーションのオブジェクト モデルの最上位オブジェクトに似ています。 たとえば、Word 文書プロジェクトで生成された ThisDocument クラスは、Word オブジェクト モデルの Document クラスと同じメンバーを提供します。 ドキュメント レベルのプロジェクトで生成されるクラスの詳細については、「 ドキュメント レベルのカスタマイズをプログラムする」を参照してください。

VSTO アドイン プロジェクトは、 ThisAddInと呼ばれる生成されたクラスを提供します。 このクラスは、ホスト アプリケーションのオブジェクト モデルのクラスに似ていません。 代わりに、このクラスは VSTO アドイン自体を表し、ホスト アプリケーションのオブジェクト モデルにアクセスしたり、VSTO アドインで使用できる他の機能にアクセスしたりするために使用できるメンバーを提供します。詳細については、「 プログラム VSTO アドイン」を参照してください。

Office プロジェクトで生成されるすべてのクラスには、 Startup イベント ハンドラーと Shutdown イベント ハンドラーが含まれます。 コードの記述を開始するには、通常、これらのイベント ハンドラーにコードを追加します。 VSTO アドインを初期化するには、 Startup イベント ハンドラーにコードを追加します。 VSTO アドインで使用されるリソースをクリーンアップするには、 Shutdown イベント ハンドラーにコードを追加します。 詳細については、「 Office プロジェクトのイベント」を参照してください。

実行時に生成されたクラスにアクセスする

Office ソリューションが読み込まれると、Visual Studio Tools for Office ランタイムによって、プロジェクトで生成された各クラスがインスタンス化されます。 Globals クラスを使用して、プロジェクト内の任意のコードからこれらのオブジェクトにアクセスできます。 たとえば、 Globals クラスを使用して、VSTO アドインのリボン ボタンのイベント ハンドラーから ThisAddIn クラスのコードを呼び出すことができます。

詳細については、「 Office プロジェクトのオブジェクトへのグローバル アクセス」を参照してください。

Office ソリューションでの名前空間に関する考慮事項

プロジェクトを作成した後で、Office プロジェクトの 既定の名前空間 (または Visual Basic の ルート名前空間 ) を変更することはできません。 既定の名前空間は、プロジェクトの作成時に指定したプロジェクト名と常に一致します。 プロジェクトの名前を変更しても、既定の名前空間は変更されません。 プロジェクトの既定の名前空間の詳細については、「アプリケーション ページ、プロジェクト デザイナー (C#)、およびアプリケーション ページ、プロジェクト デザイナー (Visual Basic)」を参照してください。

C# プロジェクトのホスト項目クラスの名前空間を変更する

ホスト項目クラス ( ThisAddIn、 ThisWorkbook、 ThisDocument クラスなど) には、Visual C# Office プロジェクトで独自の名前空間があります。 既定では、プロジェクト内のホスト項目の名前空間は、プロジェクトの作成時に指定したプロジェクト名と一致します。

Visual C# Office プロジェクトのホスト項目の名前空間を変更するには、 ホスト項目の名前空間 プロパティを使用します。 詳細については、「 Office プロジェクトのプロパティ」を参照してください。

Office プロジェクトでサポートされているプログラミング言語

Visual Studio の Office プロジェクト テンプレートでは、Visual Basic および Visual C# プログラミング言語のみがサポートされます。 そのため、これらのプロジェクト テンプレートは、Visual Studio の [新しいプロジェクト] ダイアログ ボックスの Visual Basic ノードと Visual C# ノードでのみ使用できます。 詳細については、「 方法: Visual Studio で Office プロジェクトを作成する」を参照してください。

言語の選択と Office プログラミング

Microsoft Office と Visual Basic for Applications (VBA) は、アプリケーションのカスタマイズのワークフローを最適化するために連携して開発されました。 Visual Basic では、これらの開発の一部が継承されています。 たとえば、Visual Basic では省略可能なパラメーターがサポートされています。つまり、Microsoft Office プライマリ相互運用機能アセンブリで一部のメソッドを呼び出すときに、Visual C# を使用する場合よりも少ないコードを記述できます。

Office ソリューションでの Visual Basic と Visual C# のプログラム

Visual Basic または Visual C# を使用して Office ソリューションを作成できます。 Microsoft Office オブジェクト モデルは Microsoft Visual Basic for Applications (VBA) で使用するように設計されているため、Visual Basic 開発者は、Microsoft Office アプリケーションによって公開されるオブジェクトを快適に操作できます。 Visual C# 開発者は、Visual Basic 開発者と同じ機能のほとんどを使用できますが、Office オブジェクト モデルを使用するために追加のコードを記述する必要がある場合もあります。 また、Office 開発の基本的なプログラミング機能と、Visual Basic と C# で記述されたマネージド コードにもいくつかの違いがあります。

Visual Basic と Visual C の主な違い#

次の表は、Office 開発における Visual Basic と Visual C# の主な違いを示しています。

Office 開発とマネージド コードの主な違い

次の表は、Visual Basic または Visual C# で記述された Office 開発とマネージド コードの主な違いを示しています。

関連コンテンツ

• Office ソリューションの省略可能なパラメーター
• Office プロジェクト内のオブジェクトへのグローバル アクセス
• Office プロジェクトのイベント
• 方法: プライマリ相互運用機能アセンブリを使用して Office アプリケーションをターゲットにする
• 方法: Office プロジェクトでイベント ハンドラーを作成する
• Office ソリューションでの遅延バインディング
• Office ソリューションの共同開発