文档宿主项

更新：2007 年 11 月

适用对象
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。 文档级项目 Word 2003 Word 2007 应用程序级项目 Word 2007 有关更多信息，请参见按应用程序和项目类型提供的功能。

Document 宿主项表示公开事件的 Word 文档，用作宿主控件和 Windows 窗体控件的容器。Document 宿主项还提供了 Word 的主互操作程序集中的 Microsoft.Office.Interop.Word.Document 类提供的所有属性、方法和事件。

在文档级项目中，有一个表示项目中的文档的 Document 宿主项。从 Visual Studio 2008 Service Pack 1 (SP1) 开始，您还可以通过使用 Word 2007 的应用程序级外接程序在运行时生成 Document 宿主项。

了解文档级项目中的文档宿主项

若要以编程方式访问项目中的文档，请使用 ThisDocument 类。创建文档级项目时，Visual Studio Tools for Office 会生成 ThisDocument 类以用作 Word 与您的自定义项代码之间的通信链接。ThisDocument 类派生自 Document 宿主项类。在运行时打开文档时，Visual Studio Tools for Office 会自动为您实例化 ThisDocument 类。您不应尝试直接在您的代码中实例化 Document 类。

通过使用 ThisDocument 类，可以访问 Document 宿主项的成员，以执行自定义项中的基本任务，如在打开或关闭文档时运行代码。您还可以使用此类向文档中添加控件和智能标记。通过组合不同的控件集并编写代码，可将控件绑定到数据，从用户那里收集信息并对用户操作做出响应。有关更多信息，请参见对文档级自定义项进行编程。

可以从 ThisDocument 类开始在项目中编写代码。因为此类提供的属性、方法和事件与 Word 的主互操作程序集中的 Microsoft.Office.Interop.Word.Document 类提供的属性、方法和事件完全相同，所以也可以使用 ThisDocument 访问 Word 的对象模型。有关更多信息，请参见 Word 对象模型概述。

文档宿主项限制

文档级项目只能包含一个 Document 宿主项。无法在设计时向项目添加新的 Document 宿主项，并且无法在运行时以编程方式从文档级自定义项创建新的 Document 宿主项。

如果在运行时创建新的 Word 文档，则该文档将为 Microsoft.Office.Interop.Word.Document 类型。因为它不是一个宿主项，所以它不能包含任何宿主控件或 Windows 窗体控件。有关在运行时创建文档的更多信息，请参见如何：新建文档。

了解应用程序级项目中的文档宿主项

从 SP1 开始，您可以在运行时为在 Word 中打开的任何文档生成 Document 宿主项。您可以使用 Document 宿主项向关联的文档中添加控件和智能标记。

若要生成 Document 宿主项，请使用任意 Microsoft.Office.Interop.Word.Document 对象的 GetVstoObject 方法。有关更多信息，请参见 在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿。

请参见

概念

宿主项和宿主控件概述

Word 对象模型概述

宿主项和宿主控件的编程限制

在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿

其他资源

Word 宿主控件

Excel 宿主控件

修订记录

日期	修订	原因
2008 年 7 月	增加了有关使用应用程序级项目中的 Document 宿主项的信息。	SP1 功能更改。