使用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对象必须确定的释放，调用它后你就可以确信内存中不再有剩下的没有被使用的对象了。