演练:将文档和程序集部署到本地文件夹中 (2003 System)
更新:2007 年 11 月
适用对象 |
---|
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 项目类型
Microsoft Office 版本
有关更多信息,请参见按应用程序和项目类型提供的功能。 |
本演练将演示如何将文档级自定义项部署到开发计算机上的新文件夹中,以便文档和程序集位于同一个文件夹中。此类型的部署称为本地/本地部署模型。
有关部署解决方案的选项的更多信息,请参见 部署模型 (2003 System)。有关文档级自定义项的更多信息,请参见 文档级自定义项的体系结构。
本演练阐释以下任务:
- 向位于本地文件夹中的 Visual Studio Tools for Office 解决方案程序集授予完全信任。
先决条件
您需要以下组件来完成本演练:
Visual Studio Tools for Office(Visual Studio 2008 专业版 和 Visual Studio Team System 的可选组件)。
Microsoft Office Word 2003 或 Microsoft Office Excel 2003。
说明: 此演练假定您部署的是 Word 解决方案。如果您要使用 Excel 解决方案来执行演练,请在所有代码示例中使用 Excel 项目名替换 Word 项目名。
在开发计算机上具有管理员特权,以便您可以设置安全策略。
创建要部署的解决方案
第一步是创建要部署的基本 Visual Studio Tools for Office 解决方案。如果您已经有一个要部署的解决方案,则可以跳过本节并前进至“部署解决方案”。
创建要部署的解决方案
使用适用于 Office 2003 的项目模板创建一个名为 WordDeployment 的 Word 文档项目。
在向导中,选择“创建新文档”。有关更多信息,请参见如何:创建 Visual Studio Tools for Office 项目。
在“解决方案资源管理器”中,右击 ThisDocument 代码文件,再单击“查看代码”。
将下面的代码添加到 ThisDocument_Startup 事件处理程序。文档打开时此代码将显示一条消息,以便于验证解决方案是否已成功部署。
MessageBox.Show("The deployment is successful")
MessageBox.Show("The deployment is successful");
有关 Startup 事件的更多信息,请参见 Visual Studio Tools for Office 项目事件。
按 F5 生成并运行项目。验证消息是否显示。
部署解决方案
现在,您可以将文档和程序集部署到开发计算机上的新文件夹中。
部署解决方案
在 Windows 系统驱动器 (%SystemDrive%) 的根目录中创建一个名为 TestDeploy 的文件夹。例如,如果系统驱动器是 C,则该目录将为 C:\TestDeploy。
将文档和程序集从生成输出文件夹(通常为 项目文件夹\bin\debug 或 项目文件夹\bin\release)复制到 %SystemDrive%\TestDeploy 文件夹。
在 %SystemDrive%\TestDeploy 文件夹中打开该文档。将显示一条错误信息,指出当前的 .NET 安全策略不允许该自定义项运行。这是由于您尚未对该程序集授予完全信任。
单击“确定”,然后关闭文档。
设置安全策略
必须在 .NET Framework 2.0 安全策略中向程序集授予完全信任,然后才能运行解决方案。本演练将使用代码访问安全策略工具 (Caspol.exe) 向程序集授予完全信任。
有关使用 Caspol.exe 的更多信息,请参见 代码访问安全策略工具 (Caspol.exe) 和 使用代码访问安全策略工具 (Caspol.exe) 配置安全策略。
安全说明: |
---|
为完成本演练而基于 URL 证据设置安全策略有几个基本步骤。如果您不确定位置是否安全,请不要使用这些步骤向实际解决方案中的程序集授予信任。决定实际解决方案的安全性时,还应根据更多的证据而不仅限于程序集的 URL 决定。有关更多信息,请参见 运行 Office 解决方案的安全要求 (2003 System)。 |
向程序集授予完全信任
在命令提示符处,键入以下命令以创建一个向程序集授予完全信任的新代码组。将 full assembly path 替换为程序集在开发计算机上的完整路径 -- 例如,C:\TestDeploy\WordDeployment.dll。
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
-n 参数将为新代码组指定名称。此参数不是必需的,但指定标签可以在本演练完成后更容易识别和移除新代码组。
出现提示时键入“yes”确认要执行此操作,然后按 Enter。
在 %SystemDrive%\TestDeploy 文件夹中打开该文档,然后验证是否出现该消息。
单击“确定”,然后关闭文档。
后续步骤
还可以将文档和程序集部署到同一台计算机上的不同文件夹中,或者将文档和程序集部署到网络文件夹中。有关更多信息,请参见下列演练:
请参见
任务
演练:将文档和程序集部署到不同的本地文件夹 (2003 System)
演练:将文档部署到本地文件夹并将程序集部署到网络文件夹 (2003 System)
演练:将文档和程序集部署到网络文件夹中 (2003 System)
演练:使用部署清单部署文档级自定义项 (2003 System)
演练:使用 Windows Installer 文件部署文档级自定义项 (2003 System)