Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

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

 

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.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Word. Weitere Informationen finden Sie unter Verfügbare Funktionen 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 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 und Ausführen des Projekts, um es zu testen.

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

System_CAPS_noteHinweis

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 von Visual Studio-IDE.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

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. Erweitern Sie im Vorlagenbereich Visual C# oder Visual Basic und dann Office/SharePoint.

  4. Wählen Sie unter dem erweiterten Knoten Office/SharePoint den Knoten Office-Add-Ins aus.

  5. Wählen Sie in der Liste der Projektvorlagen ein Word VSTO-Dokumentprojekt aus.

  6. Geben Sie im Feld Name die Angabe FirstDocumentCustomization ein.

  7. Klicken Sie auf OK.

    Der Projekt-Assistent aus Visual Studio Tools für Office wird geöffnet.

  8. Wählen Sie Neues Dokument erstellen aus, und klicken Sie dann auf OK.

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

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 Designer-Fenster klicken.

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

    - oder -

    Doppelklicken Sie im Projektmappen-Explorer auf die Codedatei ThisDocument.

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 unterOffice-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.

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 Dokumenthostelement und Übersicht über das Word-Objektmodell. Die restliche Klasse ThisDocument 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 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 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. 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.";
    }
    
    System_CAPS_noteHinweis

    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-Projektmappen.

So testen Sie das Dokument

  1. Drücken Sie F5, um Ihr 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 Aktualisieren von Office-Projektmappen.

  2. Vergewissern Sie sich im Dokument, dass 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.

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:

Anzeigen: