Freigeben über

Exemplarische Vorgehensweise: Erstellen ihrer ersten Anpassung auf Dokumentebene für Word

  • Artikel

Diese exemplarische Vorgehensweise bietet eine Einführung zum Erstellen einer Anpassung auf Dokumentebene für Microsoft Office Word. Die Features, die Sie in dieser Art von Lösung erstellen, sind nur verfügbar, wenn ein bestimmtes Dokument geöffnet ist. Sie können eine Anpassung auf Dokumentebene nicht verwenden, um anwendungsweite Änderungen (z. B. eine neue Registerkarte des Menübands anzuzeigen, wenn ein Dokument geöffnet ist) vorzunehmen.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines Word-Dokumentprojekts.

  • Hinzufügen von Text zu dem Dokument, das in Visual Studio-Designer gehostet wird.

  • Schreiben von Code, der das Word-Objektmodell zum Hinzufügen von Text zum angepassten Dokument verwendet, wenn dieses geöffnet wird.

  • Erstellen Sie das Projekt, und führen Sie es aus, um es zu testen.

  • Bereinigen des Projekts zum Entfernen nicht benötigter Builddateien und Sicherheitseinstellungen vom Entwicklungscomputer.

    Hinweis

    Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren der IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Projekts

So erstellen Sie ein neues Word-Dokumentprojekt in Visual Studio

  1. Starten Sie Visual Studio.

  2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  3. Wählen Sie im Dialogfeld "Neues Projekt erstellen" das Word VSTO-Dokumentprojekt aus.

    Hinweis

    Sie können auch nach Vorlagen suchen, indem Sie den Namen des Office-Produkts im Textfeld "Suchen" oben im Dialogfeld "Neues Projekt erstellen" eingeben. Die Eingabe von Excel zeigt beispielsweise alle Projektvorlagen für Excel an. Sie können auch die Liste der Vorlagen filtern, um nur die Vorlagen für Office anzuzeigen, indem Sie Office im Dropdownfeld "Projekttyp" auswählen. Weitere Informationen finden Sie unter Erstellen eines neuen Projekts in Visual Studio.

  4. Klicken Sie auf Weiter.

  5. Geben Sie "FirstWorkbookCustomization " im Feld "Name " im Dialogfeld "Neues Projekt konfigurieren" ein, und klicken Sie auf " Erstellen".

  6. Wählen Sie im Visual Studio-Tools für Den Office-Projekt-Assistenten "Neues Dokument erstellen" aus, und klicken Sie auf "OK".

    • Visual Studio erstellt das FirstDocumentCustomization-Projekt und fügt dem Projekt das FirstDocumentCustomization-Dokument und die ThisDocument-Codedatei hinzu. Das FirstDocumentCustomization-Dokument wird automatisch im Designer geöffnet.

Schließen und erneutes Öffnen des Dokuments im Designer

Wenn Sie das Dokument absichtlich oder versehentlich im Designer schließen, während Sie das Projekt entwickeln, können Sie es erneut öffnen.

So schließen Sie das Dokument im Designer und öffnen es erneut

  1. Schließen Sie das Dokument, indem Sie auf die Schaltfläche "Schließen " (X) für das Designerfenster klicken.

  2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf die Codedatei "ThisDocument", und klicken Sie auf "Designer anzeigen".

    - oder -

    Doppelklicken Sie in Projektmappen-Explorer auf die ThisDocument-Codedatei.

Hinzufügen von Text zum Dokument im Designer

Sie können die Benutzeroberfläche (User Interface, UI) Ihrer Anpassung gestalten, indem Sie das im Designer geöffnete Dokument ändern. Sie können z. B. Text, Tabellen oder Word-Steuerelemente hinzufügen. Weitere Informationen zur Verwendung des Designers finden Sie unter Office-Projekte in der Visual Studio-Umgebung.

So fügen Sie Ihrem Dokument mithilfe des Designers Text hinzu

  1. Geben Sie den folgenden Text in das Dokument ein, das im Designer geöffnet ist.

    Dieser Text wurde mithilfe des Designers hinzugefügt.

Programmgesteuertes Hinzufügen von Text zum Dokument

Fügen Sie der Codedatei "ThisDocument " nun Code hinzu. Der neue Code verwendet das Word-Objektmodell, um dem Dokument einen zweiten Textabsatz hinzuzufügen. Standardmäßig enthält die Codedatei "ThisDocument " den folgenden generierten Code:

  • Eine partielle Definition der Klasse ThisDocument, die das Programmiermodell des Dokuments darstellt und den Zugriff auf das Word-Objektmodell bereitstellt. Weitere Informationen finden Sie unter Übersicht über das Dokumenthostelement und das Word-Objektmodell. Der Rest der ThisDocument -Klasse ist in einer ausgeblendeten Codedatei definiert, die nicht geändert werden darf.

  • Die Ereignishandler ThisDocument_Startup und ThisDocument_Shutdown . Diese Ereignishandler werden aufgerufen, wenn das Dokument geöffnet und geschlossen wird. Verwenden Sie diese Ereignishandler, um Ihre Anpassung zu initialisieren, wenn das Dokument geöffnet wird, sowie zum Bereinigen von Ressourcen, die von Ihrer Anpassung verwendet werden, wenn das Dokument geschlossen wird. Weitere Informationen finden Sie unter "Ereignisse in Office-Projekten".

So fügen Sie dem Dokument mithilfe von Code einen zweiten Textabsatz hinzu

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument, und klicken Sie dann auf "Code anzeigen".

    Die Codedatei wird in Visual Studio geöffnet.

  2. Ersetzen Sie den ThisDocument_Startup -Ereignishandler durch den folgenden Code. Beim Öffnen des Dokuments fügt dieser Code dem Dokument einen zweiten Textabsatz hinzu.

    private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}

    Hinweis

    Dieser Code verwendet den Indexwert 1 in der Eigenschaft Paragraphs, um auf den ersten Absatz zuzugreifen. Obwohl Visual Basic und Visual C# auf Null basierende Arrays verwenden, ist die untere Arraygrenze der meisten Auflistungen im Word-Objektmodell 1. Weitere Informationen finden Sie unter Schreiben von Code in Office-Lösungen.

Testen des Projekts

So testen Sie das Dokument

  1. Drücken Sie F5 , um das Projekt zu erstellen und auszuführen.

    Wenn Sie das Projekt erstellen, wird der Code in eine Assembly kompiliert, die dem Dokument zugeordnet ist. Visual Studio legt eine Kopie des Dokuments und der Assembly im Buildausgabeordner für das Projekt ab und konfiguriert die Sicherheitseinstellungen auf dem Entwicklungscomputer, damit die Anpassung ausgeführt werden kann. Weitere Informationen finden Sie unter Erstellen von Office-Lösungen.

  2. Vergewissern Sie sich im Dokument, dass der folgende Text angezeigt wird.

    Dieser Text wurde mithilfe des Designers hinzugefügt.

    Dieser Text wurde per Code hinzugefügt.

  3. Schließen Sie das Dokument.

Bereinigen des Projekts

Wenn Sie die Entwicklung eines Projekts abgeschlossen haben, sollten Sie die Dateien im Buildausgabeordner und die Sicherheitseinstellungen entfernen, die durch den Buildvorgang erstellt wurden.

So bereinigen Sie das abgeschlossene Projekt auf dem Entwicklungscomputer

  1. Klicken Sie in Visual Studio im Menü Build auf Projektmappe bereinigen.

Nächste Schritte

Da Sie nun eine grundlegende Anpassung auf Dokumentebene für Word erstellt haben, können Sie mehr über die Entwicklung von Anpassungen in den folgenden Themen erfahren:

  • Allgemeine Programmieraufgaben, die Sie in Anpassungen auf Dokumentebene ausführen können: Programmanpassungen auf Dokumentebene.

  • Programmieraufgaben, die spezifisch für Anpassungen auf Dokumentebene für Word: Word-Lösungen sind.

  • Verwenden des Objektmodells von Word: Übersicht über das Word-Objektmodell.

  • Anpassen der Benutzeroberfläche von Word, z. B. durch Hinzufügen einer benutzerdefinierten Registerkarte zum Menüband oder Erstellen eines eigenen Aktionsbereichs: Anpassung der Office-Benutzeroberfläche.

  • Verwenden erweiterter Word-Objekte, die von Office-Lösungen in Visual Studio bereitgestellt werden, um Aufgaben auszuführen, die mithilfe des Word-Objektmodells nicht möglich sind (z. B. hosten verwaltete Steuerelemente in Dokumenten und Binden von Word-Steuerelementen an Daten mithilfe des Windows Forms-Datenbindungsmodells): Automatisieren Sie Word mithilfe erweiterter Objekte.

  • Erstellen und Debuggen von Anpassungen auf Dokumentebene für Word: Erstellen von Office-Lösungen.

  • Bereitstellen von Anpassungen auf Dokumentebene für Word: Bereitstellen einer Office-Lösung.

Zugehöriger Inhalt