Freigeben über

Anleitung: Erstellen Ihrer ersten Dokumentenebene-Anpassung für Word

In dieser einführenden exemplarischen Vorgehensweise erfahren Sie, wie Sie eine Anpassung auf Dokumentebene für Microsoft Office Word erstellen. 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 keine Anpassung auf Dokumentebene verwenden, um anwendungsweite Änderungen vorzunehmen, z. B. das Anzeigen einer neuen Registerkarte des Menübands, wenn ein Dokument geöffnet ist.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Word. Weitere Informationen finden Sie unter Funktionen verfügbar nach Office-Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines Word-Dokumentprojekts.

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

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

  • Erstellen und Ausführen des Projekts, um es zu testen.

  • Bereinigen des Projekts, um unnötige Builddateien und Sicherheitseinstellungen von Ihrem Entwicklungscomputer zu entfernen.

    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

Sie benötigen die folgenden Komponenten, um diese Schritt-für-Schritt-Anleitung abzuschließen.

Erstelle das Projekt

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. Klicke 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 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 bewusst oder versehentlich im Designer schließen, während Sie Ihr Projekt entwickeln, können Sie es erneut öffnen.

Zum Schließen und erneuten Öffnen des Dokuments im Designer

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

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

    – oder –

    Doppelklicken Sie im Projektmappen-Explorer auf die Codedatei "ThisDocument".

Hinzufügen von Text zum Dokument im Designer

Sie können die Benutzeroberfläche Ihrer Anpassung entwerfen, indem Sie das dokument ändern, das im Designer geöffnet ist. Sie können beispielsweise 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 im im Designer geöffneten Dokument den folgenden Text ein.

    Dieser Text wurde mithilfe des Designers hinzugefügt.

Programmgesteuertes Hinzufügen von Text zum Dokument

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

  • Eine partielle Definition der ThisDocument Klasse, die das Programmiermodell des Dokuments darstellt und Zugriff auf das Objektmodell von Word bietet. Weitere Informationen finden Sie unter Übersicht über das Dokumenthostelement und das Word-Objektmodell. Der Rest der ThisDocument Klasse wird in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.

  • Die ThisDocument_Startup und ThisDocument_Shutdown Ereignishandler. Diese Ereignishandler werden aufgerufen, wenn das Dokument geöffnet und geschlossen wird. Verwenden Sie diese Ereignishandler, um Ihre Anpassung beim Öffnen des Dokuments zu initialisieren und die von der Anpassung beim Schließen des Dokuments verwendeten Ressourcen freizugeben. 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 im 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. Wenn das Dokument geöffnet wird, 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, um auf den ersten Absatz in der Paragraphs Eigenschaft zuzugreifen. Obwohl Visual Basic und Visual C# 0-basierte Arrays verwenden, beträgt 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 Ihr Dokument

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

    Wenn Sie das Projekt erstellen, wird der Code in einer Assembly kompiliert, die dem Dokument zugeordnet ist. Visual Studio fügt eine Kopie des Dokuments und der Assembly im Buildausgabeordner für das Projekt ein und konfiguriert die Sicherheitseinstellungen auf dem Entwicklungscomputer, um die Ausführung der Anpassung zu ermöglichen. Weitere Informationen finden Sie unter Erstellen von Office-Lösungen.

  2. Überprüfen Sie im Dokument, ob der folgende Text angezeigt wird.

    Dieser Text wurde mithilfe des Designers hinzugefügt.

    Dieser Text wurde mithilfe von Code hinzugefügt.

  3. Schließen Sie das Dokument.

Bereinigen des Projekts

Wenn Sie mit der Entwicklung eines Projekts fertig sind, sollten Sie die Dateien im Buildausgabeordner und die vom Buildprozess erstellten Sicherheitseinstellungen entfernen.

Um das fertiggestellte Projekt auf Ihrem Entwicklungscomputer zu bereinigen

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

Nächste Schritte

Nachdem Sie nun eine grundlegende Anpassung auf Dokumentebene für Word erstellt haben, erfahren Sie mehr über das Entwickeln von Anpassungen aus den folgenden Themen:

Verwandte Inhalte

  • Last updated on