** 使用 ** ** Visual Studio Tools for the Microsoft Office System **
到目前为止 , 例子都是使用标准的 .NET Windows Form 应用程序来插入 ** DataSet ** 对象中的数据到 Microsoft Office 文档中。 这是一种针对 Microsoft Office System 中各种应用程序都非常 有效的技术,不论基于每个应用程序的对象模型如何改变,整个处理过程都是相同的。本质上讲,托管代码可以运行 Office ,是因为它加载了 Office 对象模型到运行程序集的进程空间。 然而,VBA开发者习惯于他们编写的代码在文档的后台执行,并且文档与VBA代码紧密相连。
这就是 Visual Studio Tools for Office 背后的部分目的。 Visual Studio Tools for Office 是一套新的 Visual Studio .NET 项目模板 , 它利用 PIAs 和 COM interop ( COM 互操作 ) 来在 Excel 和 Word 文档后台运行托管代码。 在Office文档中不论是编写还是调试VBA代码,网络影响都是类似的。仅当使用 Visual Studio Tools for Office 时, Visual Studio .NET 2003 使得编写和调试与文档紧密相连的托管代码可以在一个非常清晰的层次进行。
下一节介绍如何将数据填充到一个新建的 Word 文档中 , 整个文档是从一个模板创建的。该文档的示例代码也包含一个 Visual Studio Tools for Office 项目,该项目插入数据到一个 Excel 工作表,这与前面介绍的例子完全相似。 实际上,这两个项目都可以仅仅使用 PIAs 而不使用 Visual Studio Tools for Office 来实现。 但是, Visual Studio Tools for Office 使得在设计时和运行时连接托管代码和 Office 文档变得更为容易。
** 使用 ** ** DataSet ** ** 填充 ** ** Word2003 ** ** 模板 ** ** **
长期以来 , Office 文档中的书签 ( Bookmark ) 提供了一种便利的方式在 Word 文档中插入不连续数据片段。新建一个 Word 2003 模板,以适当格式插入书签,然后以编程方式访问书签集合以便插入数据,--这都很容易实现。
当你创建一个 Visual Studio Tools for Office 项目时 , 你可以选择是新建 Word 文档还是 Excel 文档。 在下面的例子中,项目向导创建了一个名为 VSTOWordTemplate.dot 的模板,如图 8 所示。
** 图 ** ** 8 ** ** : ** ** 一个 ** ** Word 2003 ** ** 模板 **
请注意 , 图 8 中 , 书签的插人点是作为名字 ( name ) 和地址 ( address ) 的容器的。为了编码方便,该文档设计器将书签的名字命名为与数据表中相应字段的相同的名字。
用于填充书签的值的代码非常短 , 它运行在 ** ThisDocument_New ** 事件过程 , 当从该模板新建文档时会触发该事件。 它先调用 ** GetDataSet ** 方法,以便创建 ** DataSet ** 对象,简化版的 ** GetDataSet ** 在本文前面就介绍了。 这个版本仅仅使用 Customers 表创建一个 ** DataSet ** 。
Private Sub ThisDocument_New() Handles ThisDocument.New
Dim ds As DataSet = GetDataSet()
然后 , 获得文档中书签、相关表和六个数据行的引用。最后的代码非常武断,但是真实的应用程序应该包含某些机制,让用户可以选择特定的用户名来生成这个信封。
'Fill in the document bookmarks
Dim bookmarks As Word.Bookmarks = ThisDocument.Bookmarks
Dim bookmark As Word.Bookmark
Dim dt As DataTable = ds.Tables("Customers")
Dim dr As DataRow = dt.Rows(5)
最后 , 代码遍历书签集合 , 用数据表中名字相同的字段的值替换各个书签的文本。
For Each bookmark In bookmarks
Dim bookmarkName As String = bookmark.Name
bookmark.Range.Text = dr(bookmarkName)
Next
End Sub
图9 显示运行这个过程的结果
** 图 ** ** 9 ** ** 使用 ** ** DataSet ** ** 中的数据填充书签文本 ** ** , ** ** 运行结果 **
** 关于内存管理 ** ** **
在 .NET 中与基于 COM 的 Office 对象模型交互时 , COM 对象的释放 ( disposal ) 和内存管理需要特别注意。当使用.NET编写Office解决方案时,你拥有一个.NET客户端通过运行时可调用包装( runtime-callable wrapper , RCW )与COM通信。RCW是在运行时由CRL根据 Interop 程序集中的 元数据信息动态创建的代理。 , 对于.NET客户端, RCW 表现的像任何其他 CLR 对象,但是 RCW 实际上扮演了一个代理的角色,它负责在 .NET 客户端和 COM 对象之间封送( marshalling )调用。 这种关系的副作用就是COM世界确定的对象生存期管理与.NET世界的非确定的垃圾回收之间不匹配。这种不匹配可能导致对象没有从内存释放、应用程序挂起,或者其他无法预料的行为。
使两者和谐的一种主要的方法就是为你已实例化的每个 COM 对象调用 ** Marshal.ReleaseCOMObject ** 方法。 ** Marshal.ReleaseCOMObject ** 方法规定 COM 对象必须确定的释放,调用它后你就可以确信内存中不再有剩下的没有被使用的对象了。
** 结论 ** ** **
Microsoft Office System 的编程特性和 .NET Framework 的编程模型相结合 , 引入了一种激动人心的、全新的应用程序开发机会。 Microsoft 已经引入了一些特性,桥接了 Microsoft Office System 中 COM 对象与 .NET 托管程序集之间天生的不同性质。 现在有了主互调用程序集( Primary Interop Assemblies , PIAs ), Microsoft 能够增强 PIAs 和针对 PIAs 编程的工具,当完全发挥基于 .NET 的开发的优势时,这是一个能够保证 Office 安全并且对提高生产力非常有价值的开发平台。 正是因为有了 PIAs , 我们才能够编写托管代码来维护基于 Office 的对象并且在解决方案中与之交互。 本文展示了如何通过COM互用性在Office文档中使用 ADO.NET DataSet 对象,同时也介绍了 Microsoft Office System 中各个应用程序的 XML 新特性。
** 关于作者 ** ** **
Don Kiely 是一位资深的技术顾问。 当他没有编写这类软件时 , 他就写了与之相关的文章 , 并在会议中 , 训练开发人员时发表这个方面的技术。
原文链接:
** 关于译者: **
孙泽俊 ,男, 25 岁
现就职于东软教育服务有限公司(大连),主要从事教育类软件的开发:包括多媒体课件、面对面培训实验解决方案以及相关支持软件。曾参与完成微软的 .NET 教材《 组件应用程序设计——COM+应用程序设计》一书的翻译、技术校对、实验测试等工作,该书已经由高等教育出版社出版。