VSTO 增益集的登錄專案

部署使用 Visual Studio 建立的 VSTO 增益集時,您必須建立一組特定的登錄項目。 這些登錄項目可提供讓 Microsoft Office 應用程式探索及載入 VSTO 增益集的資訊。

適用于: 本主題中的資訊適用于專案中的 VSTO [加入] - 。 如需詳細資訊,請參閱 依 Office 應用程式和專案類型提供的功能

注意

有興趣開發跨多個平臺擴充 Office 體驗的解決方案嗎? 查看新的 Office 增益集模型。 相較于 VSTO 增益集和方案,Office 增益集的使用量較小,而且您可以使用幾乎任何 web 程式設計技術(例如 HTML5、JavaScript、CSS3 和 XML)來建立這些增益集。

建置專案時,Visual Studio 會在開發電腦上建立這些登錄項目,讓您輕鬆執行和偵錯 VSTO 增益集。 如果您使用 ClickOnce 部署 VSTO 增益集,系統會在使用者電腦上自動建立登錄專案。 如果您使用 Windows Installer 部署 VSTO 增益集,您必須設定 InstallShield 限量版專案,以在終端使用者電腦上建立登錄專案。

如需如何在 VSTO 增益集載入過程中使用登錄項目的詳細資訊,請參閱 Architecture of VSTO Add-ins

注意

在本主題中, 增益集 ID 一詞代表 VSTO 增益集的唯一識別碼。 根據預設,這個識別碼是 VSTO 增益集組件的名稱。

為目前使用者和所有使用者註冊 VSTO 增益集

VSTO 增益集安裝完成後,可以使用兩種方法註冊:

  • 僅限目前使用者 (也就是,只有在) 安裝 VSTO 增益集時,登入電腦的使用者才能使用它。 在此情況下,會在 HKEY_CURRENT_USER 下建立登錄專案。

  • 對於所有使用者 (也就是說,登入電腦的任何使用者都可以使用 VSTO 增益集) 。 在此情況下,會在 HKEY_LOCAL_MACHINE 下建立登錄專案。

    以 Visual Studio 建立的所有 VSTO 增益集都能註冊以供目前的使用者使用。 不過,只有在特定情況下,才能註冊 VSTO 增益集讓所有使用者使用。 這些情況取決於電腦上的 Microsoft Office 版本以及 VSTO 增益集的部署方式。

部署類型

如果您使用 ClickOnce 部署 VSTO 增益集,VSTO 增益集只能註冊供目前使用者使用, 這是因為 ClickOnce 只支援在 HKEY_CURRENT_USER 下建立金鑰。 如果希望讓電腦的所有使用者都能使用註冊的 VSTO 增益集,則必須使用 Windows Installer 部署 VSTO 增益集。 如需這些部署類型的詳細資訊,請參閱使用 ClickOnce 部署 Office 的解決方案,以及使用 Windows Installer 部署 Office 的解決方案

登錄項目

必要的 VSTO 增益集登錄專案位於下列登錄機碼下,其中 根目錄HKEY_CURRENT_USERHKEY_LOCAL_MACHINE ,視安裝是否適用于目前的使用者或所有使用者而定。

Office應用 組態路徑
Visio \Software\Microsoft \ Visio\Addins \ 增益集識別碼
其他 \Software\Microsoft\ Office \ Office 應用程式名稱\Addins \ 增益集識別碼

注意

如果安裝程式將目標設為64位 Windows 上的所有使用者,建議它包含兩個登錄專案,一個在 HKEY_LOCAL_MACHINE\Software\Microsoft 下,另一個位於 HKEY_LOCAL_MACHINE\Software\ WOW6432Node\Microsoft hive 下。 這是因為使用者可能會在電腦上使用32位或64位版本的 Office。

如果安裝程式是以目前的使用者為目標,則不需要安裝到 WOW6432Node,因為 HKEY_CURRENT_USER\Software 的路徑是共用的。

如需詳細資訊,請參閱 Registry 中的32位和64位應用程式資料

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

進入 類型
說明 REG_SZ 必要。 VSTO 增益集的簡短描述。

當使用者在 Microsoft Office 應用程式之 [選項] 對話方塊的 [增益集] 窗格中選取 VSTO 增益集時,即會顯示這個描述。
FriendlyName REG_SZ 必要。 這是 Microsoft Office 應用程式的 [COM 增益集] 對話方塊中,所顯示之 VSTO 增益集的描述性名稱。 預設值為 VSTO 增益集 ID。
LoadBehavior REG_DWORD 必要。 可指定應用程式何時嘗試載入 VSTO 增益集和 VSTO 增益集目前狀態 (載入或卸載) 的值。

這個項目預設會設定為 3,指定在啟動時載入 VSTO 增益集。 如需詳細資訊,請參閱 LoadBehavior 值注意: 如果使用者停用 VSTO 增益集,該動作會修改 HKEY_CURRENT_USER 登錄 hive 中的 LoadBehavior 值。 針對每個使用者,HKEY_CURRENT_USER hive 中 LoadBehavior 值的值會覆寫 HKEY_LOCAL_MACHINE hive 中定義的預設 LoadBehavior
file:/// REG_SZ 必要。 VSTO 增益集部署資訊清單的完整路徑。 路徑可以是本機電腦上的位置、網路共用 (UNC) 或 Web 伺服器 (HTTP)。

如果使用 Windows Installer 來部署解決方案,您必須在 資訊清單 路徑前加上前置詞 file:/// 。 您也必須將字串附加 |vstolocal (也就是管道字元 | 後面接著 vstolocal) 到此路徑的結尾。 如此可以確保解決方案是從安裝資料夾載入,而不是從 ClickOnce 快取載入。 如需詳細資訊,請參閱使用 Windows Installer 部署 Office 的解決方案注意: 當您在開發電腦上建立 VSTO 增益集時,Visual Studio 會自動將 |vstolocal 字串附加到這個登錄專案。

Outlook 表單區域的登錄專案

如果您在 Outlook 的 VSTO 增益集中建立自訂表單區域,則必須使用額外的登錄項目向 Outlook 註冊這個表單區域。 系統會在表單區域所支援之各個訊息類別的不同登錄機碼下建立這些項目。 這些登錄機碼位於下列位置,其中 根目錄HKEY_CURRENT_USERHKEY_LOCAL_MACHINE

Root\Software\Microsoft\ Office \ Outlook \FormRegions \ message 類別

當您建置專案時,Visual Studio 會在開發電腦上建立表單區域登錄項目,如同所有 VSTO 增益集共用的其他登錄項目一樣。 如果您使用 ClickOnce 部署 VSTO 增益集,系統會在使用者電腦上自動建立登錄專案。 如果您使用 Windows Installer 部署 VSTO 增益集,您必須設定 InstallShield 限量版專案,以在終端使用者電腦上建立登錄專案。

如需表單區域登錄專案的詳細資訊,請參閱 在自訂表單中指定表單區域的位置。 如需 Outlook 表單區域的詳細資訊,請參閱建立 Outlook 表單區域

LoadBehavior 值

\Software\Microsoft\ 下的 LoadBehavior 專案 Office \ 應用程式名稱\Addins \ 增益集識別碼 索引鍵包含值的位元組合,這些值會指定 VSTO 增益集的執行時間行為。 最低順序位元 (值 0 和 1) 表示 VSTO 增益集目前處於卸載或載入狀態。 其他位元則表示應用程式嘗試載入 VSTO 增益集的時間。

一般來說,當 VSTO 增益集安裝在終端使用者電腦上時, LoadBehavior 專案的目的是要設為十進位) 中的0、3或 16 (。 根據預設,當您建置或發行 VSTO 增益集時,Visual Studio 會將 VSTO 增益集的 LoadBehavior 項目設定為 3。

下表列出 LoadBehavior 項目所有可能的值: 這個表格中的部分描述是指手動或以程式設計方式載入 VSTO 增益集。 若要手動載入 VSTO 增益集,請在應用程式的 [COM 增益集] 對話方塊中,選取 [VSTO 增益集] 旁的核取方塊。 若要以程式設計方式載入 VSTO 增益集,請將代表 VSTO 增益集之 Connect 物件的 COMAddIn 屬性設定為 true

值 (十進位) VSTO 增益集狀態 VSTO 增益集載入行為 描述
0 已卸載 不自動載入 應用程式永遠不會嘗試自動載入 VSTO 增益集。 使用者可以嘗試手動載入 VSTO 增益集,或是以程式設計方式載入 VSTO 增益集。

如果成功載入 VSTO 增益集, LoadBehavior 值會維持為 0,但 [COM 增益集] 對話方塊中的 VSTO 增益集狀態會更新,表示已載入 VSTO 增益集。
1 已載入 不自動載入 應用程式永遠不會嘗試自動載入 VSTO 增益集。 使用者可以嘗試手動載入 VSTO 增益集,或是以程式設計方式載入 VSTO 增益集。

雖然 [ COM 增益集] 對話方塊指出 VSTO 增益集會在應用程式啟動後載入,但在手動或以程式設計方式載入之前,並不會載入 VSTO 增益集。

如果應用程式成功載入 VSTO 增益集, LoadBehavior 值會變成 0,並在應用程式關閉後維持為 0。
2 已卸載 啟動時載入 應用程式不會嘗試自動載入 VSTO 增益集。 使用者可以嘗試手動載入 VSTO 增益集,或是以程式設計方式載入 VSTO 增益集。

如果應用程式成功載入 VSTO 增益集, LoadBehavior 值會變成 3,並在應用程式關閉後維持為 3。
3 已載入 啟動時載入 應用程式在啟動時嘗試載入 VSTO 增益集。 如果您在 Visual Studio 中建置或發行 VSTO 增益集,這就是預設值。

如果應用程式成功載入 VSTO 增益集, LoadBehavior 值會維持為 3。 如果載入 VSTO 增益集時發生錯誤, LoadBehavior 值會變成 2,並在應用程式關閉後維持為 2。
8 已卸載 視需要載入 應用程式不會嘗試自動載入 VSTO 增益集。 使用者可以嘗試手動載入 VSTO 增益集,或是以程式設計方式載入 VSTO 增益集。

如果應用程式成功載入 VSTO 增益集, LoadBehavior 值會變成 9。
9 已載入 視需要載入 只有在需要時,應用程式才會載入 VSTO 增益集,例如使用者按下使用 VSTO 增益集功能的 UI 項目時 (例如功能區的自訂按鈕)。

如果應用程式成功載入 VSTO 增益集, LoadBehavior 值會維持為 9,但 [COM 增益集] 對話方塊中的 VSTO 增益集狀態會更新,表示目前已載入 VSTO 增益集。 如果載入 VSTO 增益集時發生錯誤, LoadBehavior 值會變成 8。
16 已載入 第一次載入,之後則視需求載入 如果您希望依需求載入 VSTO 增益集,請設定為這個值。 使用者首次執行應用程式時,應用程式會載入 VSTO 增益集。 使用者下次執行應用程式時,應用程式會載入 VSTO 增益集已定義的任何 UI 項目,但在使用者按下與 VSTO 增益集相關聯的 UI 項目之前,不會載入 VSTO 增益集。

應用程式首次成功載入 VSTO 增益集時, LoadBehavior 值會在 VSTO 增益集載入時維持為 16。 應用程式關閉後, LoadBehavior 值會變成 9。

另請參閱