使用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+应用程序设计》一书的翻译、技术校对、实验测试等工作,该书已经由高等教育出版社出版。