文档宿主项

  • 项目

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

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

在文档级项目中，有代表你的项目中的文档的默认 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 工作簿。

相关内容