Compartilhar via


Como: Documentos de referência na coleção de documentos

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

  • Projetos de nível de documento

  • Projetos de nível de aplicativo

Versão do Microsoft Office

  • Word 2003

  • Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode referir a um objeto Microsoft.Office.Interop.Word.Document como um membro da coleção Documents usando o nome do documento ou seu valor de índice na coleção.

Referência a um documento por seu nome é normalmente a melhor opção se desejar trabalhar com um documento específico.Você raramente consulte um documento usando o valor de índice na coleção Documents porque esse valor pode alterar para um determinado documento conforme outros documentos estão abertos e Fechadas.

Fazendo referência a documentos

Para fazer referência um documento pelo seu nome

  • Defina uma variável de objeto para apontar para o documento nomeado, SampleDoc.doc.Para usar o exemplo de código a seguir, execute o código da ThisDocument ou ThisAddIn classe seu projeto.

    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); 
    

Se você quiser consulte o documento ativo (o documento que tem o foco), você pode usar a propriedade ActiveDocument do objeto Application.

Para fazer referência do documento ativo

  • Recupere o nome do documento ativo usando ActiveDocument.Para usar o exemplo de código a seguir, execute o código da ThisDocument ou ThisAddIn classe seu projeto.

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

Se você apenas estiver trabalhando com o documento que está associado com uma personalização de nível de documento, podem usar a referência de Globals.ThisDocument de qualquer local no projeto quando você precisar consulte o documento que tem o foco.

Para fazer referência o documento associado a uma personalização de nível de documento

  • Recupere o nome do documento usando Globals.ThisDocument.

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

Consulte também

Tarefas

Como: Abrir documentos existentes

Como: Inserir texto em documentos do Word

Conceitos

Global Acessar a objetos no Visual Studio Tools para projetos do Office

Itens de host e Visão geral sobre controles de host