Elemento host DocumentDocument host item

El elemento host Document es un tipo que extiende el tipo Document del ensamblado de interoperabilidad primario de Word.The Document host item is a type that extends the Document type from the primary interop assembly for Word. Asimismo, el elemento host Document proporciona las mismas propiedades, métodos y eventos que un objeto Document y, además, también expone eventos adicionales y sirve de contenedor para los controles host y para los controles de Windows Forms.The Document host item provides all of the same properties, methods, and events as a Document object, but it also exposes additional events and acts as a container for host controls and Windows Forms controls.

Se aplica a: La información de este tema se aplica al documento-proyectos y agregar de VSTO de nivel-en los proyectos de Word.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. Para obtener más información, consulte características disponibles por tipo de aplicación y el proyecto de Office.For more information, see Features available by Office application and project type.

En los proyectos de nivel de documento, existe un elemento host Document predeterminado que representa al documento del proyecto.In document-level projects, there is a default Document host item that represents the document in your project. En los proyectos de complemento de VSTO, puede generar elementos host Document en tiempo de ejecución.In VSTO Add-in projects, you can generate Document host items at run time.

Comprender el elemento host document en los proyectos de nivel de documentoUnderstand the document host item in document-level projects

Para obtener acceso al documento del proyecto, utilice la clase ThisDocument .To access the document in your project, use the ThisDocument class. Cuando se crea un proyecto de nivel de documento, Visual Studio genera la clase ThisDocument para que sirva como vínculo de comunicación entre Word y el código de personalización.When you create a document-level project, Visual Studio generates the ThisDocument class to serve as the communication link between Word and your customization code. La clase ThisDocument le da acceso a los miembros del elemento host Document para que pueda realizar tareas básicas durante la personalización, como por ejemplo, ejecutar el código cuando el documento se abre o se cierra.The ThisDocument class gives you access to members of the Document host item to perform basic tasks in your customization, such as running code when the document is opened or closed. También puede usar esa clase para agregar controles al documento.You can also use the class to add controls to the document. Si combina diferentes conjuntos de controles y escribe el código, puede enlazar los controles a los datos, recopilar información del usuario y responder a las acciones del usuario.By combining different sets of controls and writing code, you can bind the controls to data, collect information from the user, and respond to user actions. Para obtener más información, consulte programar personalizaciones de nivel de documento.For more information, see Program document-level customizations.

La clase ThisDocument proporciona una ubicación en la que puede empezar a escribir el código del proyecto.The ThisDocument class provides a location in which you can start writing code in your project. Como esta clase proporciona las mismas propiedades, métodos y eventos que el objeto Document que se encuentra en el ensamblado de interoperabilidad primario de Word, también puede usar ThisDocument para obtener acceso al modelo de objetos de Word.Because the class provides all of the same properties, methods, and events as the Document object in the primary interop assembly for Word, you can also use ThisDocument to access the object model of Word. Para obtener más información, consulte información general sobre el modelo de objetos de Word.For more information, see Word object model overview.

Limitaciones del elemento host document en los proyectos de nivel de documentoLimitations of the document host item in document-level projects

Un proyecto de nivel de documento puede contener solamente un elemento host Document (es decir, la clase ThisDocument ).A document-level project can contain only one Document host item (that is, the ThisDocument class). No puede agregar nuevos Document elementos host para el proyecto en tiempo de diseño, y que no se puede crear nuevos Document elementos en tiempo de ejecución desde una personalización de nivel de documento host.You cannot add new Document host items to your project at design time, and you cannot create new Document host items at runtime from a document-level customization.

Si crea un nuevo documento de Word en tiempo de ejecución, será del tipo Document.If you create a new Word document at runtime, it will be of the type Document. Como no se trata de un elemento host, este no puede contener controles host ni controles de Windows Forms.Because it is not a host item, it cannot contain any host controls or Windows Forms controls. Para obtener más información sobre la creación de documentos en tiempo de ejecución, vea Cómo: Crear nuevos documentos mediante programación.For more information about creating documents at run time, see How to: Programmatically create new documents.

Comprender los elementos host de documento en los proyectos de nivel de aplicaciónUnderstand document host items in application-level projects

En los proyectos de complemento VSTO, puede generar en tiempo de ejecución un elemento host Document para cualquier documento que esté abierto en Word.In VSTO Add-in projects, you can generate a Document host item at run time for any document that is open in Word. Puede usar el elemento host Document para agregar controles al documento asociado, o para administrar los eventos que no estén disponibles en los objetos Document .You can use the Document host item to add controls to the associated document, or to handle events that are not available on Document objects.

Para generar un elemento host Document, use el método GetVstoObject.To generate a Document host item, use the GetVstoObject method. Para obtener más información, consulte documentos ampliar Word y libros de Excel en complementos VSTO en tiempo de ejecución.For more information, see Extend Word documents and Excel workbooks in VSTO Add-ins at runtime.

Vea tambiénSee also