應用程式層級增益集的登錄項目

更新：2007 年 11 月

適用於
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 專案類型 應用程式層級專案 Microsoft Office 版本 2007 Microsoft Office system Microsoft Office 2003 如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

在部署透過 Visual Studio Tools for Office 建立的增益集時，必須建立一組特定的登錄項目。這些登錄項目所提供的資訊可供 Microsoft Office 應用程式用來探索與載入增益集。如需詳細資訊，請參閱應用程式層級增益集的架構。

在建置專案時，Visual Studio Tools for Office 會在開發電腦上建立這些登錄項目，方便您對增益集進行偵錯。如需詳細資訊，請參閱 Office 方案建置程序概觀。

如需在部署增益集時，如何在使用者電腦上建立登錄機碼的詳細資訊，請參閱部署 Office 方案 (2007 系統) 和部署應用程式層級增益集 (2003 系統)。

在本主題中，文字 add-in ID 代表增益集的唯一 ID。根據預設，這個 ID 就是增益集專案的名稱。

2007 Microsoft Office System 的登錄項目

除了 Microsoft Office Visio 之外，2007 Microsoft Office system 之所有應用程式的必要增益集登錄項目全都位於下列登錄機碼中：

HKEY_CURRENT_USER\Software\Microsoft\Office\application name\Addins\add-in ID

Visio 的登錄項目則是位於下列登錄機碼中：

HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\add-in ID

注意事項：
2007 Microsoft Office system 中的應用程式只能辨識已登錄在 HKEY_CURRENT_USER 底下的 Visual Studio Tools for Office 增益集。也就是說，您無法在 HKEY_LOCAL_MACHINE 底下登錄增益集，將 2007 Microsoft Office system 的 Visual Studio Tools for Office 增益集部署到電腦的所有使用者中。

下表列出這個登錄機碼底下必要的項目。

項目	類型	值
Description	REG_SZ	增益集的簡短說明。 當使用者在 Microsoft Office 應用程式的 [選項] 對話方塊中選取了 [增益集] 窗格中的增益集時，就會顯示這段說明。
FriendlyName	REG_SZ	增益集的描述性名稱，它會顯示在 Microsoft Office 應用程式的 [COM 增益集] 對話方塊中。預設值為增益集 ID。
LoadBehavior	REG_DWORD	數值，指定應用程式何時會嘗試載入增益集，以及增益集目前狀態 (載入或未載入)。 根據預設，這個項目會設定為 3，表示要在啟動時載入增益集。如需詳細資訊，請參閱 LoadBehavior 值。
Manifest	REG_SZ	增益集之部署資訊清單的完整路徑。這個路徑可以是本機電腦上的位置、網路共用 (UNC)，或是 Web 伺服器 (HTTP)。 注意事項： 當您在開發電腦上建置增益集時，Visual Studio Tools for Office 會將字串 |vstolocal (即管道字元 | 後加上 vstolocal) 附加至這個登錄項目。這樣一來，當您在開發電腦上透過 Visual Studio 來執行增益集時，可以協助 Visual Studio Tools for Office 載入增益集。

Outlook 表單區域的登錄項目

如果您在 Microsoft Office Outlook 2007 的增益集中建立自訂表單區域，便會使用登錄項目向 Outlook 登錄此表單區域。這個登錄項目位於下列機碼中：

HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions\message class

如需詳細資訊，請參閱在 Windows 登錄中指定表單區域。如需 Outlook 表單區域的詳細資訊，請參閱建立 Outlook 表單區域。

Microsoft Office 2003 登錄項目

Microsoft Office 2003 的必要增益集登錄項目位於下列登錄機碼底下：

• HKEY_CURRENT_USER\Software\Microsoft\Office\application name\Addins\add-in ID

• HKEY_CURRENT_USER\Software\Classes\add-in ID\CLSID

• HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}

• HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\InprocServer32

• HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\ProgID

• HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\Programmable

• HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\VersionIndependentProgID

注意事項：
您可以在 HKEY_LOCAL_MACHINE 底下 (而不是 HKEY_CURRENT_USER) 建立登錄機碼，讓電腦上的所有使用者都可以使用 Microsoft Office 2003 的 Visual Studio Tools for Office 增益集。

下列各節列出每個登錄機碼底下的必要項目。文字 add-in CLSID 代表增益集的全域唯一類別識別項 (CLSID)。若要取得增益集的 CLSID，可以參考下列其中一個位置：

• HKEY_CURRENT_USER\Software\Classes\add-in ID\CLSID 登錄項目的預設值；當您建置增益集時，開發電腦上便會建立這個項目。

• csproj (C#) 或 .vbproj (Visual Basic) 專案檔中的 ProjectGuid 項目。

注意事項：
如果您打算將 Microsoft Office 2003 增益集部署至 Windows Vista，就必須將下列清單中的一些登錄項目建立在不同的樹狀子目錄中。如需詳細資訊，請參閱 Windows Vista 上的 Microsoft Office 2003 增益集登錄項目。

HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\<add-in ID>

注意事項：
如果是 Visio 增益集，請使用下列機碼：HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\add-in ID

項目	類型	值
Description	REG_SZ	增益集的簡短說明。
FriendlyName	REG_SZ	增益集的描述性名稱，它會顯示在 Microsoft Office 應用程式的 [COM 增益集] 對話方塊中。預設值為增益集 ID。
LoadBehavior	REG_DWORD	數值，指定應用程式何時會嘗試載入增益集，以及增益集目前狀態 (載入或未載入)。 根據預設，這個項目會設定為 3，表示要在啟動時載入增益集。如需詳細資訊，請參閱 LoadBehavior 值。
Manifest	REG_SZ	增益集之應用程式資訊清單的完整路徑。這必須是用戶端電腦上的本機資料夾。

HKEY_CURRENT_USER\Software\Classes\add-in ID

項目	類型	值
(Default)	REG_SZ	增益集的說明。

HKEY_CURRENT_USER\Software\Classes\add-in ID\CLSID

項目	類型	值
(Default)	REG_SZ	增益集的全域唯一類別識別項 (CLSID)。

HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}

項目	類型	值
(Default)	REG_SZ	增益集的說明。

HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\InprocServer32

項目	類型	值
(Default)	REG_SZ -或- REG_EXPAND_SZ	在電腦上，執行增益集的 Visual Studio Tools for Office 載入器完整路徑。這個項目應該永遠設為 %CommonProgramFiles%\Microsoft Shared\VSTO\8.0\AddinLoader.dll。 如需 Visual Studio Tools for Office 載入器的詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。 注意事項： 如果您在路徑中使用環境變數，請在這個項目中使用 REG_EXPAND_SZ 型別。否則，請使用 REG_SZ 型別。
ManifestLocation	REG_SZ	增益集之應用程式資訊清單的路徑。這必須是用戶端電腦上的本機資料夾。
ManifestName	REG_SZ	增益集之應用程式資訊清單的名稱。
ThreadingModel	REG_SZ	執行緒模型。這個項目必須設定為 Both。

HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\ProgID

項目	類型	值
(Default)	REG_SZ	增益集的唯一 ID。

HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\Programmable

項目	類型	值
(Default)	REG_SZ	請勿設定這個項目的值。

HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\VersionIndependentProgID

項目	類型	值
(Default)	REG_SZ	與版本無關的增益集唯一 ID。

Windows Vista 上的 Microsoft Office 2003 增益集登錄項目

如果您打算將 Microsoft Office 2003 增益集部署至執行 Windows Vista 的電腦上，而且符合下列情況，就必須將一些登錄機碼建立在不同的登錄樹狀子目錄中：

• 使用者使用完整的系統管理員存取權狀來執行 Microsoft Office 2003 應用程式。

  -或-

• 使用者已關閉「使用者帳戶控制」(UAC)。

在這些情況中，您必須將 COM 登錄機碼 (亦即，所有在 HKEY_CURRENT_USER\Software\Classes 底下定義的機碼) 改為建立在 HKEY_LOCAL_MACHINE\Software\Classes 底下。

在這些情況中，由於 Windows Vista 只會在 HKEY_LOCAL_MACHINE 底下尋找 COM 登錄機碼，因此您必須使用 Machine 樹狀子目錄。如需如何在預設的安裝專案中變更登錄機碼的詳細資訊，請參閱應用程式層級增益集的安裝專案 (2003 系統)。

注意事項：
在這些情況中，請勿將位於 HKEY_CURRENT_USER\Software\Microsoft 底下的登錄機碼移除。

LoadBehavior 值

HKEY_CURRENT_USER\Software\Microsoft\Office\application name\Addins\add-in ID 機碼 (Key) 底下的 LoadBehavior 項目包含一個值，這個值會指定應用程式嘗試載入增益集的時機，以及增益集目前的狀態 (已載入或未載入)。根據預設，在您建置或部署增益集時，這個項目會設為 3。

下表列出 LoadBehavior 項目可能的值。

值 (小數)	值的意義	說明
0	未載入	應用程式不會在啟動時嘗試載入增益集。使用者可以嘗試透過應用程式中的 [COM 增益集] 對話方塊，手動載入增益集。
1	已載入	應用程式不會在啟動時嘗試載入增益集。使用者可以嘗試透過應用程式中的 [COM 增益集] 對話方塊，手動載入增益集。
2	啟動時載入 | 未載入	應用程式會在啟動時嘗試載入增益集。 如果應用程式順利載入增益集，LoadBehavior 值就會變更為 3。
3	啟動時載入 | 已載入	應用程式會在啟動時嘗試載入增益集。 如果應用程式順利載入增益集，LoadBehavior 值會保持在 3。如果在載入增益集時出現錯誤，LoadBehavior 值就會變更為 2。
8	視需要載入 | 未載入	應用程式只會在需要時嘗試載入增益集，例如當使用者按一下使用者介面 (UI) 項目而觸發了增益集中的功能時。 如果應用程式順利載入增益集，LoadBehavior 值就會變更為 9。
9	視需要載入 | 已載入	應用程式只會在需要時嘗試載入增益集，例如當使用者按一下 UI 項目而觸發了增益集中的功能時。 如果應用程式順利載入增益集，LoadBehavior 值會保持在 9。如果在載入增益集時出現錯誤，LoadBehavior 值就會變更為 8。
16	第一次啟動時載入	應用程式會在使用者第一次執行它時載入增益集。下一次應用程式啟動時，就會載入增益集所定義的任何 UI 項目，但是會等到使用者按一下與增益集相關聯的 UI 項目時，才會載入增益集。 如果應用程式在下一次啟動時順利載入增益集，LoadBehavior 值就會變更為 9。

請參閱

概念

應用程式層級增益集的架構

Office 方案建置程序概觀

部署 Office 方案 (2007 系統)

部署應用程式層級增益集 (2003 系統)

其他資源

Visual Studio Tools for Office 方案的架構