文档宿主项

主机 Document 项是一种类型,它从 Word 的主互作程序集扩展 Document 类型。 宿主 Document 项提供与对象相同的所有属性、方法和事件 Document ,但它还会公开其他事件,并充当主机控件和 Windows 窗体控件的容器。

适用于: 本主题中的信息适用于 Word 的文档级项目和 VSTO 外接程序项目。 有关详细信息,请参阅 Office 应用程序和项目类型提供的功能

在文档级项目中,有一个默认 Document 宿主项,表示项目中的文档。 在 VSTO 外接程序项目中,可以在运行时生成 Document 主机项。

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

若要访问项目中的文档,请使用 ThisDocument 类。 创建文档级项目时,Visual Studio 将 ThisDocument 生成类,用作 Word 与自定义代码之间的通信链接。 该 ThisDocument 类允许你访问主机项的成员 Document 以在自定义中执行基本任务,例如打开或关闭文档时运行代码。 还可以使用该类向文档添加控件。 通过组合不同的控件集和编写代码,可以将控件绑定到数据、从用户收集信息以及响应用户作。 有关详细信息,请参阅 程序文档级自定义

ThisDocument 类提供一个位置,你可以在其中开始在项目中编写代码。 由于该类提供与 Word 的主互作程序集中的对象相同的所有属性、方法和事件 Document ,因此还可以用于 ThisDocument 访问 Word 的对象模型。 有关详细信息,请参阅 Word 对象模型概述

文档级项目中文档宿主项的限制

文档级项目只能包含一个 Document 宿主项(即 ThisDocument 类)。 不能在设计时向项目添加新 Document 宿主项,并且无法在运行时从文档级自定义项创建新的 Document 宿主项。

如果在运行时创建新的 Word 文档,它将是该类型 Document。 由于它不是主机项,因此它不能包含任何主机控件或 Windows 窗体控件。 有关在运行时创建文档的详细信息,请参阅 如何:以编程方式创建新文档

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

在 VSTO 外接程序项目中,可以在运行时为 Word 中打开的任何文档生成 Document 主机项。 可以使用 Document 宿主项将控件添加到关联的文档,或处理对象上 Document 不可用的事件。

若要生成 Document 宿主项,请使用 GetVstoObject 该方法。 有关详细信息,请参阅 运行时在 VSTO 外接程序中扩展 Word 文档和 Excel 工作簿