Gewusst wie: Verweisen auf Dokumente in der Documents-Auflistung

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Dokumentebene Projekte auf Anwendungsebene Microsoft Office-Version Word 2003 Word 2007 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Sie können auf ein Microsoft.Office.Interop.Word.Document-Objekt als Member der Documents-Auflistung verweisen, indem Sie den Namen des Dokuments oder seinen Indexwert in der Auflistung verwenden.

Wenn Sie mit einem bestimmten Dokument arbeiten möchten, empfiehlt sich ein Verweis auf den Dokumentnamen. Der Verweis auf ein Dokument anhand des Indexwerts in der Documents-Auflistung ist unüblich, da sich dieser Wert für ein bestimmtes Dokument durch das Öffnen und Schließen anderer Dokumente ändern kann.

Verweisen auf Dokumente

So verweisen Sie auf ein Dokument anhand seines Namens

• Legen Sie eine Objektvariable fest, die auf das Dokument mit dem Namen SampleDoc.doc zeigt. Wenn Sie das folgende Codebeispiel verwenden möchten, führen Sie den Code von der ThisDocument-Klasse bzw. der ThisAddIn-Klasse im Projekt aus.

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

Wenn Sie auf das aktive Dokument (das Dokument mit dem Fokus) verweisen möchten, können Sie die ActiveDocument-Eigenschaft des Application-Objekts verwenden.

So verweisen Sie auf das aktive Dokument

• Rufen Sie den Namen des aktiven Dokuments mithilfe von ActiveDocument ab. Wenn Sie das folgende Codebeispiel verwenden möchten, führen Sie den Code von der ThisDocument-Klasse bzw. der ThisAddIn-Klasse im Projekt aus.

  Dim documentName As String = Application.ActiveDocument.Name
  

  string documentName = Application.ActiveDocument.Name;
  

Sollten Sie nur mit dem Dokument arbeiten, das einer Anpassung auf Dokumentebene zugeordnet ist, können Sie den Globals.ThisDocument-Verweis von einer beliebigen Stelle im Projekt verwenden, um auf das Dokument mit dem Fokus zu verweisen.

So verweisen Sie auf das einer Anpassung auf Dokumentebene zugeordnete Dokument

• Rufen Sie den Namen des Dokuments mithilfe von Globals.ThisDocument ab.

  Dim documentName2 As String = Globals.ThisDocument.Name
  

  string documentName2 = Globals.ThisDocument.Name;
  

Siehe auch

Aufgaben

Gewusst wie: Öffnen vorhandener Dokumente

Gewusst wie: Einfügen von Text in Word-Dokumente

Konzepte

Globaler Zugriff auf eigene Objekte in Visual Studio Tools for Office-Projekte

Übersicht über Hostelemente und Hoststeuerelemente