Office 解决方案部署疑难解答

本主题包含有关如何的信息解决可能会遇到的常见问题。在部署 Office 解决方案。

**适用于:**本主题中的信息适用于 Office 2013 和 Office 2010 的文档级项目和应用程序级项目。请参见按 Office 应用程序和项目类型提供的功能

使用事件查看器对 Office 解决方案进行疑难解答

安装或卸载 Office 解决方案时,可以使用 Windows 中的事件查看器来查看 Visual Studio Tools for Office Runtime捕获的错误消息。可以使用事件记录器中的这些消息来解决安装和部署问题。有关更多信息,请参见Office 解决方案的事件日志

更改程序集名称引起冲突

如果将 项目设计器应用程序 页的 程序集名称 值,在已经部署解决方案后,发布工具会将安装程序包包含一个 Setup.exe 文件,并且部署清单。如果要部署两个清单文件,以下情况可能发生:

  • 如果最终用户一并安装这两个版本,应用程序将相应加载两个外接程序。

  • 如果外接程序是在程序集名称更改之前安装的,最终用户将永远接收不到更新。

在部署解决方案之后,为了避免这种情况,请不要更改解决方案的 程序集名称 值。

检查更新耗时很长

Visual Studio for Office runtime 2010 个工具提供管理员可以使用下载清单和解决方案的注册表项和解决方案。 

设置超时值

  1. 在注册表中,导航到下面一项:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. 在**“AddInTimeout”**子项中以毫秒为单位设置超时值。

    如果 AddInTimeout 子项不存在,请创建为一个。

无法更新或发布到网络文件共享

如果网络文件共享上的 Office 解决方案的 Setup.exe 文件在发布更新的过程中在某个进程中锁定,则该解决方案可能会在更新过程中显示误导性的消息。该消息可能显示如下:“无法将‘setup.exe’添加到网站。此网站中已存在文件‘setup.exe’。”

若要帮助防止文件锁定,可以将该网络文件共享对最终用户设置为只读。但是,如果该网络文件共享中有文档,这些文档对最终用户也是只读的。

对于未安装 Microsoft Office 系统

可以将 .NET framework、Visual Studio Tools for Office Runtime和 Office 主互操作程序集 (pia) 到安装程序包以部署与 Office 解决方案的系统必备组件。有关如何安装主互操作程序集的信息,请参见将计算机配置为开发 Office 解决方案如何:安装 Office 主互操作程序集

使用“Localhost”发布可能导致安装问题

当您使用“https://localhost”为发布或安装位置对于文档级解决方案时,发布向导 不会将该字符串转换为真实的计算机名称。在这种情况下,在开发计算机上安装解决方案。若要让部署的解决方案在开发计算机上使用 IIS,可为所有 HTTP/HTTPS/FTP 位置使用完全限定的名称,而不是使用 localhost。

加载的是缓存的程序集而不是更新的程序集

合成,.NET framework 程序集加载程序,加载程序集的缓存副本,将项目输出路径位于网络文件共享上时,程序集签名与一个强名称,并且,自定义项的程序集版本不更改。如果要更新的程序集符合这些条件,更新下次不会显示您运行项目,因为该缓存的副本加载。

可以配置 Visual Studio,使得 Fusion 在每次运行项目时都下载程序集。

下载程序集而不是加载缓存的副本

  1. 在菜单栏上,选择 项目,ProjectName属性

  2. 应用程序 页上,选择 程序集信息

  3. 在第一个 程序集版本 框中,键入星号 (*),然后选择 确定 按钮。

在更改程序集版本后,可以继续对您的具有强名称的程序集,并且 fusion 将加载自定义项的最新版本。

当 URI 包含字符该 Are't US-ASCII,安装失败

当您将 Office 解决方案发布到 HTTP/HTTPS/FTP 位置时,路径不能与在 US-ASCII 的任何 Unicode 字符。这样的字符可能导致安装程序中出现不一致的行为。请为目标路径使用 US-ASCII 字符。

在开发计算机上发布和安装解决方案时,显示手动卸载的提示

在生成 Office 解决方案时,生成的版本会自动注册。如果您以前发布和安装了同一解决方法添加到您的开发计算机,Visual Studio Tools for Office Runtime 会检测到发布版本的安装路径和生成的版本不同,如解决方案生成,然后重新生成或发布后。错误消息会显示“由于已经安装了另一版本的自定义项且不能从该位置升级,无法安装该自定义项”。注册表项,都会更新解决方案会重新生成。因此,在中,在发布,调试或运行新版本之前,您必须卸载旧版本。

若要阻止出现该消息,请在开发计算机上创建另一个用户帐户来测试部署。或者,在发布,接下来调试或重新生成解决方案之前,可以卸载从已安装程序列表的版本计算机上的。

安装解决方案时出现“未捕获的异常”或“未找到方法”错误

当您通过打开部署清单来安装 Office 解决方案时 (.vsto 文件),Office 应用程序,文档,或工作簿,以下条件的错误消息可能出现:

  • 未找到方法。

  • MissingMethodException。

  • 未捕获的异常。

若要防止这些错误消息出现,请通过运行安装程序来安装解决方案。

在安装解决方案时,不用运行安装程序,安装程序将不检查或安装系统必备组件。安装程序将检查系统必备组件的正确版本,并根据需要进行安装。

外接程序更改的清单注册表项在 InstallShield limited Edition 项目后生成

作为外接程序安装程序的一部分的清单注册表项从 .vsto 有时更改为 .dll.manifest,在生成 InstallShield limited Edition 项。

若要解决此问题,请创建 InstallShield limited Edition 项目在不同的解决方法或使用 CompanyName.AddinName 作为包含外接程序的名称注册表项的值。

您的 Office 解决方案的 ClickOnce 安装程序没有安装主互操作程序集

在运行 ClickOnce 为您的 Office 解决方案创建的安装程序时,Office 主互操作程序集的 (PIAs) 安装程序运行时,只有 + 当尚未安装插入样式中。

如果安装程序没有正确安装插入样式中,请通过运行名为 o2007pia.msi 从安装目录的安装程序文件来手动安装它们。

重新安装 Office 解决方案导致参数超出范围异常

当您重新安装 Office 解决方案时,ArgumentOutOfRangeException 异常可能会出现以下错误消息:指定的参数超出有效值的大小。

如果安装位置 URL 的大小写的不同,这种情况。例如,因此,如果安装了从 https://fabrikam.com/ExcelSolution.vstohttps://fabrikam.com/excelsolution.vsto 二次,第一次的 Office 解决方案然后使用了会出现此错误。

在安装 Office 解决方案时,若要避免出现此消息,请使用相同的大小写。

无法通过打开部署安装 ClickOnce 解决方案清单从 Web

用户可以通过打开部署 Office 解决方案安装清单从 web。但是,internet 信息服务 (IIS) 的内置阻止 .vsto 文件扩展名。在使用它来部署 Office 解决方案之前,必须定义 MIME 输入 IIS。

有关如何定义 MIME 的信息输入 IIS 6,请参见 配置 MIME 类型 (IIS 6.0)

有关如何定义 MIME 的信息输入 IIS 7,请参见 添加一个 MIME 类型 (IIS7)。

将扩展到 .vsto 和 MIME 类型设置 application/x MSvsto。

请参见

概念

ClickOnce 部署疑难解答

其他资源

部署 Office 解决方案