アプリケーション レベルのアドインのレジストリ エントリ

更新 : 2010 年 5 月

Visual Studio 2010 で作成したアドインを配置するときには、一連のレジストリ エントリを作成する必要があります。 それらのレジストリ エントリで指定する情報によって、Microsoft Office アプリケーションはアドインを検出し、読み込むことができます。

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

プロジェクトをビルドすると、Visual Studio によって開発用コンピューター上にレジストリ エントリが作成されるので、アドインを簡単に実行およびデバッグできます。 ClickOnce を使用してアドインを配置する場合は、エンド ユーザーのコンピューター上にレジストリ エントリが自動的に作成されます。 Windows インストーラーを使用してアドインを配置する場合は、セットアップ プロジェクトを構成して、エンド ユーザーのコンピューター上にレジストリ エントリを作成する必要があります。

アドインの読み込みプロセス中にレジストリ エントリがどのように使用されるかについては、「アプリケーション レベルのアドインのアーキテクチャ」を参照してください。

現在のユーザー用のアドイン登録とすべてのユーザー用のアドイン登録

インストールされたアドインは、2 つの方法で登録できます。

• 現在のユーザーのみ (アドインのインストール時にコンピューターにログオンしていたユーザーのみが使用可能)。 この場合、レジストリ エントリは HKEY_CURRENT_USER の下に作成されます。

• すべてのユーザー (コンピューターにログオンしたすべてのユーザーがアドインを使用可能)。 この場合、レジストリ エントリは HKEY_LOCAL_MACHINE の下に作成されます。

Visual Studio 2010 を使用して作成したすべてのアドインは、現在のユーザー用に登録できます。 ただし、特定のシナリオに限り、アドインをすべてのユーザー用に登録できます。 これらのシナリオは、コンピューター上の Microsoft Office のバージョン、およびアドインの配置方法によって異なります。

Microsoft Office のバージョン

Microsoft Office 2010 アプリケーションは、HKEY_LOCAL_MACHINE または HKEY_CURRENT_USER に登録されているアドインを読み込むことができます。

既定では、2007 Microsoft Office system のアプリケーションは、HKEY_CURRENT_USER に登録されているアドインのみを読み込むことができます。 HKEY_LOCAL_MACHINE に登録されたアドインを読み込むには、これらのアプリケーションがインストールされているコンピューターに、修正プログラム パッケージ 976477 もインストールされている必要があります。 詳細については、https://go.microsoft.com/fwlink/?LinkId=184923 を参照してください。

配置タイプ

ClickOnce を使用してアドインを配置する場合は、現在のユーザー用にのみアドインを登録できます。 これは、ClickOnce が HKEY_CURRENT_USER の下へのキーの作成のみをサポートしているためです。 アドインをコンピューター上のすべてのユーザー用に登録する場合は、Windows インストーラーを使用してアドインを配置する必要があります。 これらの配置タイプの詳細については、「Office ソリューションの発行」および「Windows インストーラーを使用した Office ソリューションの配置」を参照してください。

レジストリ エントリ

必要なアドイン レジストリ エントリは、Visio を除くすべてのアプリケーションで次のレジストリ キーの下にあります。"Root" は HKEY_CURRENT_USER または HKEY_LOCAL_MACHINE です。

Root\Software\Microsoft\Office\<アプリケーション名>\Addins\<アドイン ID>

Visio の場合、レジストリ エントリは次のレジストリ キーの下にあります。

Root\Software\Microsoft\Visio\Addins\<アドイン ID>

このレジストリ キーの下にあるエントリを次の表に示します。

エントリ	タイプ	値
Description	REG_SZ	必須。 アドインの簡単な説明。 この説明は、ユーザーが Microsoft Office アプリケーションの [オプション] ダイアログ ボックスの [アドイン] ペインでアドインを選択したときに表示されます。
FriendlyName	REG_SZ	必須。 Microsoft Office アプリケーションの [COM アドイン] ダイアログ ボックスに表示される、アドインの説明的な名前。 既定値はアドイン ID です。
LoadBehavior	REG_DWORD	必須。 アプリケーションがアドインを読み込んだ時点とアドインの現在の状態 (読み込まれているかアンロードされたか) を示す値。 このエントリの既定値は 3 です。これは、アドインが起動時に読み込まれたことを示します。 詳細については、「LoadBehavior の値」を参照してください。
Manifest	REG_SZ	必須。 アドインの配置マニフェストの完全パス。 ローカル コンピューター上の場所、ネットワーク共有 (UNC)、Web サーバー (HTTP) のいずれかを指定できます。 Windows インストーラーを使用してソリューションを配置する場合、文字列「|vstolocal」(パイプ文字 | の後ろに "vstolocal") をこのパスの最後に追加します。 これにより、ClickOnce キャッシュではなく、インストール フォルダーからソリューションが読み込まれます。 詳細については、「Windows インストーラーを使用した Office ソリューションの配置」を参照してください。 メモ 開発用コンピューターでアドインをビルドすると、Visual Studio によって文字列 "|vstolocal" が自動的にレジストリ エントリに追加されます。
Warmup	REG_DWORD	省略可能。 アドインを読み込む前に .NET Framework と Visual Studio Tools for Office Runtime を読み込んで、認識されるアドイン読み込み時間を短縮することを示す値です。 Warmup エントリを 1 に設定し、LoadBehavior エントリと組み合わせて使用して、Windows インストーラー (.msi) を使用して配置された Outlook 2010 アドインの読み込み時間を短縮します。 このレジストリ キーは、ClickOnce を使用して設定することはできません。

Outlook フォーム領域のレジストリ エントリ

Outlook 用アドインにカスタム フォーム領域を作成する場合は、フォーム領域を Outlook に登録するために追加のレジストリ エントリが使用されます。 これらのエントリは、フォーム領域がサポートするメッセージ クラスごとに異なるレジストリ キーの下に作成されます。 これらのレジストリ キーは次の場所にあります。"Root" は HKEY_CURRENT_USER または HKEY_LOCAL_MACHINE です。

Root\Software\Microsoft\Office\Outlook\FormRegions\<メッセージ クラス>

すべてのアドインで共有されるその他のレジストリ エントリと同様に、プロジェクトをビルドすると、Visual Studio によって開発用コンピューター上にフォーム領域レジストリ エントリが作成されます。 ClickOnce を使用してアドインを配置する場合は、エンド ユーザーのコンピューター上にレジストリ エントリが自動的に作成されます。 Windows インストーラーを使用してアドインを配置する場合は、セットアップ プロジェクトを構成して、エンド ユーザーのコンピューター上にレジストリ エントリを作成する必要があります。

フォーム領域レジストリ エントリの詳細については、「Specifying Form Regions in the Windows Registry (Windows レジストリ内のフォーム領域の指定)」を参照してください。 Outlook フォーム領域の詳細については、「Outlook フォーム領域の作成」を参照してください。

LoadBehavior の値

Root\Software\Microsoft\Office\<アプリケーション名>\Addins\<アドイン ID> キーの下にある LoadBehavior エントリには、アドインの実行時の動作を指定する値のビットごとの組み合わせが含まれています。 最下位のビット (値 0 および 1) は、アドインが現在アンロードされているか、または読み込み済みであるかを示します。 その他のビットは、アプリケーションがアドインを読み込もうとしていることを示します。

通常、アドインがエンド ユーザーのコンピューターにインストールされている場合は、LoadBehavior エントリは 10 進数の 0、3、または 16 に設定されます。 既定では、アドインをビルドまたは発行すると、Visual Studio によってアドインの LoadBehavior エントリが 3 に設定されます。

LoadBehavior エントリに指定できるすべての値を次の表に示します。 この表では、アドインを手動またはプログラムによって読み込む場合も示されています。 アドインを手動で読み込むには、アプリケーションの [COM アドイン] ダイアログ ボックスで、アドインの横にあるチェック ボックスをオンにします。 アドインをプログラムによって読み込むには、アドインを表す COMAddIn オブジェクトの Connect プロパティを true に設定します。

参照

概念

アプリケーション レベルのアドインのアーキテクチャ

Office ソリューション ビルド処理の概要

Office ソリューションの配置

その他の技術情報

Visual Studio の Office ソリューションのアーキテクチャ

履歴の変更