Office 方案部署疑難排解

本節將包含解決常見問題的秘訣,您可能在部署 Office 方案時遇到這些問題。

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

使用事件檢視器疑難排解 Office 方案

您可以使用 Windows 中的事件檢視器,查看安裝或解除安裝 Office 方案時,Visual Studio Tools for Office Runtime 擷取的錯誤訊息。 您可以從事件記錄器使用這些訊息解決安裝和部署的問題。 如需詳細資訊,請參閱Office 方案的事件記錄

變更組件名稱造成衝突

如果您在已部署方案之後,變更 [專案設計工具] 的 [應用程式] 頁中的 [組件名稱] 值,則發行工具將修改安裝套件以包含一個 Setup.exe 檔和兩個部署資訊清單。 部署兩個資訊清單檔可能造成下列情況發生:

  • 如果使用者安裝兩個版本,則應用程式將載入兩個版本的增益集。

  • 如果增益集是在組件名稱變更之前安裝,則使用者將不會收到更新。

為避免這些情況發生,部署方案之後請勿變更方案的 [組件名稱] 值。

檢查更新需要較長的時間

Visual Studio 2010 Tools for Office Runtime 提供登錄項目,可讓系統管理員設定下載資訊清單和方案的逾時值。 

設定逾時值

  1. 在登錄中瀏覽至下列機碼:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. 在 [AddInTimeout] 子機碼中,設定以毫數為單位的逾時值。

    如果 [AddInTimeout] 子機碼不存在,則建立該機碼為 DWORD。

無法更新或發行至網路檔案共用

如果方案的 Setup.exe 檔在更新發行時遭鎖定在處理序中,則位於網路檔案共用上的 Office 方案可能在更新期間顯示誤導的訊息。 訊息可能表示下列內容:「無法將 'setup.exe' 加入 Web。'setup.exe' 檔已存在此 Web 中。」(Unable to add 'setup.exe' to the Web. The file 'setup.exe' already exists in this Web)。

為協助避免檔案鎖定,您可以針對使用者將共用設為唯讀。 不過,如果文件位於共用上,則同樣會針對使用者變成唯讀。

未安裝 Microsoft Office 的必要條件

您可以將 Microsoft .NET Framework、Visual Studio Tools for Office Runtime 和 Microsoft Office 主要 Interop 組件加入至安裝套件,做為隨 Office 方案部署的必要條件。 如需如何安裝主要 Interop 組件的詳細資訊,請參閱設定電腦以開發 Office 方案HOW TO:安裝 Office 主要 Interop 組件

使用 'Localhost' 發行可能造成安裝問題

當您使用 "https://localhost" 做為文件層級方案的發行或安裝位置時,[發行精靈] 不會將字串轉換成真實的電腦名稱。 這表示方案只能安裝在開發電腦上。 若要讓部署的方案在開發電腦上使用 IIS,請針對所有 HTTP/HTTPS/FTP 位置使用完整名稱,而不要使用 localhost。

載入快取的組件而不是更新的組件

融合為 .NET Framework 組件載入器,會在專案輸出路徑位於網路檔案共用上時載入快取的組件副本,組件的設計為使用強式名稱,而自訂的組件版本不會變更。 如果您更新符合這些條件的組件,則下次執行專案時將不會看見更新,因為會載入快取的副本。

您可以設定 Visual Studio,如此 Fusion 會在每次專案執行時下載組件。

下載組件而非載入快取副本

  1. 按一下 [專案] 功能表上的 [ProjectName 屬性]。

  2. 在 [應用程式] 頁中,按一下 [組件資訊]。

  3. 在第一個 [組件版本] 方塊中輸入星號 (*)。

  4. 按一下 [確定]。

在您變更組件版本後,可繼續以強式名稱簽署組件,而且融合將載入最新版的自訂。

未登錄文件層級自訂中的 XML 結構描述

如果您將 XML 結構描述附加至 2007 Microsoft Office System 文件層級專案的文件中,則結構描述不會在使用者程式庫中登錄。 您必須另外建立安裝程式檔來執行這項操作。 如需詳細資訊,請參閱文件層級自訂中的 XML 結構描述和資料

URI 包含不是 US-ASCII 的字元時安裝會失敗

當您發行 Office 方案至 HTTP/HTTPS/FTP 位置時,路徑不可有任何不是 US-ASCII 的 Unicode 字元。 這類字元可能導致安裝程式發生不一致的行為。 請針對安裝路徑使用 US-ASCII 字元。

當您在開發電腦上發行和安裝方案時,會出現手動解除安裝的提示

當您建置 Office 方案時,建置的版本會自動註冊。 如果您先前已將相同的方案發行和安裝到開發電腦,Visual Studio Tools for Office Runtime 會在下一次建置、重建或發行後,偵測到已發行的版本和建置版本不同。 錯誤訊息如下:「無法安裝自訂,因為目前安裝了其他版本,而且無法從這個位置進行升級」。由於重新建置方案會更新登錄機碼,因此您必須先解除安裝第一個版本,再發行、偵錯或執行第二個版本。

為避免這個訊息出現,請在開發電腦上建立另一個使用者帳戶來測試部署。 或者,您可以從電腦上已安裝程式的清單中解除安裝版本,然後再發行、偵錯或重建下一個方案。

當您安裝方案時,發生無法攔截的例外狀況或找不到方法的錯誤

當您藉由開啟部署資訊清單 (.vsto 檔案)、Office 應用程式、文件或活頁簿來安裝 Office 方案時,可能會看到因為發生下列狀況而出現的錯誤訊息:

  • 找不到方法。

  • MissingMethodException。

  • 無法攔截的例外狀況。

若要避免出現這些錯誤訊息,請執行安裝程式以安裝方案。

當您不是以執行安裝程式的方式安裝方案時,安裝程式就不會檢查或安裝必要條件。 安裝程式會檢查必要條件的正確版本,並視需要加以安裝。

建置 Windows Installer 安裝專案後,增益集的資訊清單登錄機碼發生變更

當您建置 Windows Installer 安裝專案時,屬於增益集安裝程式一部分的資訊清單登錄機碼 (Registry Key) 有時候會從 .vsto 變更為 .dll.manifest。

若要解決此問題,請在不同的方案中建立安裝專案,或使用包含增益集名稱的 CompanyName.AddinName 做為登錄機碼的值。

適用於 Office 方案的 ClickOnce 安裝程式未安裝主要的 Interop 組件

當您執行 ClickOnce 為 Office 方案所建立的安裝程式 (Setup Program) 時,只有在尚未安裝 Office 主要 interop 組件 (PIA) 的情況下,PIA 的安裝程式 (Installer) 才會執行。

如果安裝程式 (Setup Program) 未正確安裝 PIA,請從安裝目錄執行名為 o2007pia.msi 的安裝程式 (Installer) 檔案,手動安裝 PIA。

重新安裝 Office 方案會導致引數超出範圍例外狀況

重新安裝 Office 方案時,可能會看到具有下列錯誤訊息的 ArgumentOutOfRangeException 例外狀況:「指定的引數超出有效值的範圍。」

如果安裝位置 URL 的大小寫不同,就會發生這個錯誤。 例如,如果第一次從 https://fabrikam.com/ExcelSolution.vsto 安裝 Office 方案,第二次改成使用 https://fabrikam.com/excelsolution.vsto,便會發生這項錯誤。

若要避免出現此訊息,安裝 Office 方案時請使用相同的大小寫。

請參閱

概念

疑難排解 ClickOnce 部署

其他資源

部署 Office 方案