[导入]将程序集链接到 Word 或 Excel 文件
包含托管代码扩展的 Microsoft Office 2003 文档需要具有指向它的关联程序集的路径。此路径及程序集名称存储于文档的自定义属性 _AssemblyLocation0 和 _AssemblyName0 中。路径必须具有以下格式之一:
- 绝对路径 (
C:\Assemblies\
) - 相对路径 (
\Assemblies\
) - HTTP (
http://www.contoso.com/assemblies/
) - UNC (
\\AssemblyServer\Assemblies\
)
有关有效路径的更多信息,请参见“程序集链接位置”属性。
如果程序集名称或位置的长度超过 255 个字符,将按编号顺序在 Office 文档中添加更多的自定义属性以包含超出的字符。例如,如果程序集位置包含 300 个字符,则需要两个属性:_AssemblyLocation0 和 _AssemblyLocation1。
在 Word 或 Excel 文件中设置程序集名称和位置
可在 Word 或 Excel 文件的自定义属性中设置程序集名称和位置,有以下三种方法:
- 在 Visual Studio .NET 中使用“属性”窗口(建议)。
- 运行用于设置属性的脚本。
- 在文档中手动设置属性,既可以在 Windows 资源管理器中也可在应用程序自身中进行设置。
不是所有文档格式都支持自定义属性。例如,如果将文档保存为文本文件 (.txt),则不保存程序集信息。
在 Visual Studio .NET 中使用“属性”窗口将程序集链接到文件
- 在生成解决方案之前,在“属性”窗口中将“程序集链接位置”项目属性设置为程序集的位置。
在 Visual Studio .net 项目中使用“属性”窗口有助于在项目与部署的解决方案之间保持同步。
使用脚本将程序集链接到文件
通过脚本使用 Persistence Control 更改文档中的 _AssemblyLocation0 自定义属性。
- 创建一个脚本,以实例化该控件并调用希望使用的方法。有关方法的详细信息,请参见 Persistence Control 方法。
例如,使用 JScript:
// JScript if (WScript.Arguments.Length < 3) { print("Usage: SetAssemblyNameAndLocation <document> <assembly> <location>") print("") print(" <document> is the name of a Word document or Excel spreadsheet") print(" <assembly> is the name of the assembly, without the extension") print(" <location> can be a relative path, and should end in a slash") WScript.Quit(1) } var doc = WScript.Arguments(0) var asm = WScript.Arguments(1) var loc = WScript.Arguments(2) print("Updating '" + doc + "', setting assembly='" + asm + "' and location='" + loc + "'") try { var control = new ActiveXObject("OfficeToolkit.Persistence") control.SetAssemblyNameAndLocation(doc, asm, loc) print("Success!") } catch(e) { print("Error:") print(e.number + ": " + e.description) WScript.Quit(2) } function print(s) { WScript.Echo(s) }
以下代码使用 VBScript 演示同一个示例:
' VBScript If (WScript.Arguments.Length < 3) Then print "Usage: SetAssemblyNameAndLocation <document> <assembly> <location>" print "" print " <document> is the name of a Word document or Excel spreadsheet" print " <assembly> is the name of the assembly, without the extension" print " <location> can be a relative path, and should end in a slash" WScript.Quit 1 End If Dim doc Dim asm Dim loc doc = WScript.Arguments(0) asm = WScript.Arguments(1) loc = WScript.Arguments(2) print "Updating '" & doc & "', setting assembly='" & asm & _ "' and location='" & loc & "'" On Error Resume Next Dim control Set control = CreateObject("OfficeToolkit.Persistence") control.SetAssemblyNameAndLocation doc, asm, loc If (Err.Number <> 0) Then print "Error:" print Err.Number & ": " & Err.Description WScript.Quit 2 End If On Error Goto 0 print "Success!" Sub print(s) WScript.Echo s End Sub
- 使用有具体含义的名称保存文件,并在文件名末尾添加扩展名 .js(使用 JScript)或 .vbs(使用 VBScript)。
- 打开命令提示。
- 将目录更改为保存脚本文件的位置。
- 键入脚本文件的名称(不带扩展名),后跟三个参数(按以下顺序):
<script file> <document name> <assembly name> <deployment location>
- 按 ENTER 键。
此示例脚本对加密的工作簿或非本机文件类型(如 HTML 或 MHT)无效。有关更多信息,请参见安全部署中的“部署加密的 Excel 工作簿”。
通过在 Word 或 Excel 中手动更改属性来链接程序集
- 在 Word 或 Excel 中打开文档。
- 打开“文件”菜单,单击“属性”。
文档或工作簿的“属性”对话框随即打开。
- 单击“自定义”选项卡。
- 在“属性”列表中,选择 _AssemblyLocation0。
用该属性的数据填充位于对话框顶部的字段。
- 将包含程序集的目录的路径添加到“值”字段。
注意 Windows 资源管理器在“属性”对话框的“值”字段中不接受长度超过 255 个字符的值。
- 在“属性”列表中选择 _AssemblyName0。
- 将程序集的名称(不带文件扩展名)添加到“值”字段。
- 单击“确定”。
通过使用 Windows 资源管理器手动更改属性来链接程序集
- 打开 Windows 资源管理器,浏览至文档或工作簿,然后选中它。
- 打开“文件”菜单,单击“属性”。
文档或工作簿的“属性”对话框随即打开。
- 单击“自定义”选项卡。
“自定义”选项卡上的“属性”列表中不显示自定义文档属性,但您仍可通过手动键入名称和值来更改属性值。
注意 如果打开了没有自定义属性的文档或工作簿,“自定义”选项卡不会显示在任何文档或工作簿的“属性”对话框中。如果在“属性”对话框中看不到“自定义”选项卡,请关闭所有打开的文档或工作簿,然后重新启动此过程。
- 在“名称”字段中,键入 _AssemblyLocation0。
- 在“值”字段中键入包含程序集的目录的路径。
注意 Windows 资源管理器在“属性”对话框的“值”字段中不接受长度超过 255 个字符的值。
- 在“名称”字段中键入 _AssemblyName0。
- 在“值”字段中键入程序集的名称(不带文件扩展名)。
- 单击“确定”。
文章来源:http://www.cnblogs.com/suiqirui19872005/archive/2007/06/03/769674.html