图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是一位资深的技术顾问。当他没有编写这类软件时,他就写了与之相关的文章,并在会议中,训练开发人员时发表这个方面的技术。
原文链接:
http://msdn.microsoft.com/office/default.aspx?pull=/library/en-us/dno2k3ta/html/ODC_Office2003ADONET.asp
关于译者:
孙泽俊,男,25岁
现就职于东软教育服务有限公司(大连),主要从事教育类软件的开发:包括多媒体课件、面对面培训实验解决方案以及相关支持软件。曾参与完成微软的.NET教材《组件应用程序设计——COM+应用程序设计》一书的翻译、技术校对、实验测试等工作,该书已经由高等教育出版社出版。