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

更新：2010 年 5 月

在部署透過 Visual Studio 2010 建立的增益集時，必須建立一組特定的登錄項目。 這些登錄項目所提供的資訊可供 Microsoft Office 應用程式用來探索與載入增益集。

**適用於：**本主題中的資訊適用於 Microsoft Office 2010 和 2007 Microsoft Office system 的應用程式層級專案。 如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

在建置專案時，Visual Studio 會在開發電腦上建立這些登錄項目，方便您執行及偵錯增益集。 如果您使用 ClickOnce 部署您的增益集，會自動在使用者電腦上建立登錄項目。 如果您使用 Windows 安裝程式部署增益集，您必須設定設定專案在使用者電腦上建立登錄項目。

如需關於如何在載入增益集處理序期間使用登錄項目的詳細資訊，請參閱應用程式層級增益集的架構.

注意事項
在本主題中，文字 add-in ID 代表增益集的唯一 ID。 根據預設，這個 ID 就是增益集組件的名稱。

為目前的使用者登錄增益集與所有使用者

安裝增益集時，可以透過兩種方式將其註冊：

• 僅限目前的使用者 (也就是說，僅適用於安裝增益集時登入電腦的使用者)。 在這種情況下，會在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 下的增益集，安裝這些應用程式的電腦還必須安裝 Hotfix 封裝 976477。 如需詳細資訊，請參閱 https://go.microsoft.com/fwlink/?LinkId=184923。

部署類型

如果您使用 ClickOnce 部署增益集，只能為目前的使用者登錄該增益集。 這是因為 ClickOnce 僅支援建立 HKEY_CURRENT_USER 下的機碼。 如果您想要為電腦上的所有使用者登錄增益集，必須使用Windows 安裝程式部署該增益集。 如需關於這些部署型別的詳細資訊，請參閱發行 Office 方案和使用 Windows Installer 部署 Office 方案。

登錄項目

必要的增益集登錄項目是位於除 Visio 之外所有應用程式的以下登錄機碼中，其中一個 Root 表示 HKEY_CURRENT_USER 或 HKEY_LOCAL_MACHINE。

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

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

根\Software\Microsoft\Visio\Addins\增益集 ID

下表列出此登錄機碼下的項目。

Entry	型別	值
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 Installer 部署 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\message class

如同其他由所有增益集共用的登錄項目，當您建置專案時，Visual Studio 會在開發電腦上建立表單區域登錄項目。 如果您使用 ClickOnce 部署您的增益集，會自動在使用者電腦上建立登錄項目。 如果您使用 Windows 安裝程式部署增益集，您必須設定設定專案在使用者電腦上建立登錄項目。

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

LoadBehavior 值

Root\Software\Microsoft\Office\應用程式名稱\Addins\增益集 ID 機碼之下的 LoadBehavior 項目包含值的位元組合，可指定增益集的執行階段行為。 最低的順序位元 (值 0 和 1) 會指出增益集目前已卸載或載入。 其他位元指出應用程式嘗試載入增益集的時間。

將增益集安裝在使用者電腦中時，LoadBehavior 項目通常應設定為 0、3 或 16 (以十進位)。 預設情況下，當您建置或發行增益集時，Visual Studio 會將增益集的 LoadBehavior 項目設定為 3。

下表列出 LoadBehavior 項目所有可能的值。 這個資料表中的某些描述會參考手動或以程式設計的方式載入的增益集。 若要手動載入增益集，請在應用程式的 [COM 增益集] 對話方塊中，選取增益集旁的核取方塊。 若要以程式設計的方式載入增益集，請將代表增益集之 COMAddIn 物件的 Connect 屬性設定為 true。

值 (小數)	增益集狀態	增益集載入行為	描述
0	Unloaded	不會自動載入	應用程式絕對不會嘗試自動載入增益集。 使用者可以嘗試以手動方式載入增益集，或者以程式設計的方式載入增益集。 如果已順利載入增益集，LoadBehavior 值保持 0，但是 [COM 增益集] 對話方塊中的增益集會更新以表示已載入增益集。
1	Loaded	不會自動載入	應用程式絕對不會嘗試自動載入增益集。 使用者可以嘗試以手動方式載入增益集，或者以程式設計的方式載入增益集。 雖然 [COM 增益集] 對話方塊指出增益集已在應用程式啟動後載入，但實際上增益集並未載入，直到以手動或程式設計方式載入為止。 如果應用程式順利載入增益集，LoadBehavior 値會變更為 0，並在應用程式關閉後仍保持 0。
2	Unloaded	在啟動時載入	應用程式不會嘗試自動載入增益集。 使用者可以嘗試以手動方式載入增益集，或者以程式設計的方式載入增益集。 如果應用程式順利載入增益集，LoadBehavior 値會變更為 3，並在應用程式關閉後仍保持 3。
3	Loaded	在啟動時載入	應用程式會在啟動時嘗試載入增益集。 這是當您在 Visual Studio 中建置發行增益集時的預設值。 如果應用程式順利載入增益集，LoadBehavior 會保持為 3。 如果載入增益集時發生錯誤，LoadBehavior 值會變更為 2，並在應用程式關閉後仍保持為 2。
8	Unloaded	視需要載入	應用程式不會嘗試自動載入增益集。 使用者可以嘗試以手動方式載入增益集，或者以程式設計的方式載入增益集。 如果應用程式順利載入增益集，LoadBehavior 值就會變更為 9。
9	Loaded	視需要載入	只有當應用程式要求增益集時，才會載入增益集，例如當使用者按一下會使用增益集功能的 UI 項目時 (例如功能區中的自訂按鈕)。 如果應用程式順利載入增益集，LoadBehavior 值會保持 9，但是 [COM 增益集] 對話方塊中的增益集狀態會更新，表示目前已載入增益集。 如果在載入增益集時發生錯誤，LoadBehavior 值會變更為 8。
16	Loaded	載入第一次，然後依需要載入	如果您想隨選載入您的增益集，請設定這個値。 應用程式會在使用者第一次執行它時載入增益集。 下一次使用者執行應用程式時，就會載入增益集所定義的任何 UI 項目，但是會等到使用者按一下與增益集相關聯的 UI 項目時，才會載入增益集。 當應用程式第一次成功載入增益集時，LoadBehavior 值會保留 16，同時載入增益集。 應用程式關閉之後，LoadBehavior 值會變更為 9。

請參閱

概念

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

Office 方案建置程序概觀

其他資源

Office 方案在 Visual Studio 中的架構

部署 Office 方案

變更記錄

日期	記錄	原因
2010 年 5 月	提供更多關於在資訊清單項目中使用 |vstolocal 的內容。	資訊加強。