Cómo: Hacer referencia a documentos en la colección Documents

Actualización: noviembre 2007

Se aplica a

La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados.

Tipo de proyecto

  • Proyectos de nivel de documento

  • Proyectos de nivel de aplicación

Versión de Microsoft Office

  • Word 2003

  • Word 2007

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Si desea hacer referencia a un objeto Microsoft.Office.Interop.Word.Document como miembro de la colección Documents, puede utilizar el nombre del documento o su valor de índice en la colección.

La referencia a un documento por su nombre es normalmente la opción idónea para trabajar con un documento concreto. Rara vez se hace referencia a un documento por su valor de índice en la colección Documents ya que este valor puede variar para un documento dado a medida que se abren y cierran otros documentos.

Referencias a documentos

Para hacer referencia a un documento por su nombre

  • Establezca una variable de objeto de modo que señale al documento denominado SampleDoc.doc. Para usar el ejemplo de código siguiente, ejecute el código desde las clases ThisDocument o ThisAddIn del proyecto.

    Dim doc As Word.Document = CType(Application.Documents("SampleDoc.doc"), Word.Document)
    
    object fileName = "SampleDoc.doc"; 
    Word.Document doc = Application.Documents.get_Item(ref fileName); 
    

Si desea hacer referencia al documento activo (el documento que tiene el foco), puede utilizar la propiedad ActiveDocument del objeto Application.

Para hacer referencia al documento activo

  • Recupere el nombre del documento activo mediante la propiedad ActiveDocument. Para usar el ejemplo de código siguiente, ejecute el código desde las clases ThisDocument o ThisAddIn del proyecto.

    Dim documentName As String = Application.ActiveDocument.Name
    
    string documentName = Application.ActiveDocument.Name;
    

Si sólo está trabajando con el documento asociado a la personalización de nivel de documento, puede utilizar la referencia Globals.ThisDocument desde cualquier lugar del proyecto cuando necesite hacer referencia al documento que tiene el foco.

Para hacer referencia al documento asociado a una personalización de nivel de documento

  • Recupere el nombre del documento activo mediante el evento Globals.ThisDocument.

    Dim documentName2 As String = Globals.ThisDocument.Name
    
    string documentName2 = Globals.ThisDocument.Name;
    

Vea también

Tareas

Cómo: Abrir documentos existentes

Cómo: Insertar texto en documentos de Word

Conceptos

Acceso global a objetos en proyectos de Visual Studio Tools para Office

Información general sobre elementos y controles Host