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

Artikel
02/26/2013

In dieser einführenden exemplarischen Vorgehensweise wird Ihnen erläutert, wie Sie eine Anpassung auf Dokumentebene für Microsoft Office Word erstellen können.Die Features, die Sie in dieser Art von Projektmappe erstellen, sind nur für die Anwendung verfügbar, wenn ein bestimmtes Dokument geöffnet ist.Sie können Anpassungen auf Dokumentebene nicht verwenden, um anwendungsweite Änderungen vorzunehmen, z. B. das Anzeigen einer neuen Menübandregisterkarte, wenn ein beliebiges Dokument geöffnet ist.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Word 2013 und Word 2010. 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 einem in Visual Studio Designer gehosteten Dokument
Schreiben von Code, der das Word-Objektmodell zum Hinzufügen von Text zu einem angepassten Dokument beim Öffnen des Dokuments verwendet
Erstellen und Ausführen des Projekts zum Testen
Bereinigen des Projekts zum Entfernen nicht benötigter Builddateien und Sicherheitseinstellungen vom Entwicklungscomputer

Hinweis
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

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

Eine Version von Visual Studio 2012, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.110\).md).

Word 2013 oder Word 2010.

Erstellen des Projekts

So erstellen Sie ein neues Word-Dokumentprojekt in Visual Studio

Starten Sie Visual Studio.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Erweitern Sie im Vorlagenbereich den Visual C# oder Visual Basic, und erweitern Sie dann Office/SharePoint.
unter dem erweiterten Knoten Office/SharePoint wählen Sie den Knoten Office-Add-Ins aus.
Wählen Sie in der Liste der Projektvorlagen Word 2010-Dokument oder Word 2013-Dokument aus.
Geben Sie im Feld Name den Namen FirstDocumentCustomization ein.
Klicken Sie auf OK.

Der Projekt-Assistent aus Visual Studio Tools for Office wird geöffnet.
Wählen Sie Neues Dokument erstellen aus, und klicken Sie 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.

Schließen und erneutes Öffnen des Dokuments im Designer

Wenn Sie das Dokument im Designer absichtlich oder versehentlich 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

Schließen Sie das Dokument, indem Sie auf die Schaltfläche Schließen (X) im Designerfenster klicken.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Codedatei ThisDocument, und klicken Sie danach auf Ansicht-Designer.

- 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 gestalten, indem Sie das geöffnete Dokument im Designer ändern.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 mit dem Designer dem Dokument Text hinzu

Geben Sie in das geöffnete Dokument den folgenden Text ein.

This text was added by using the designer.

Programmgesteuertes Hinzufügen von Code zum Dokument

Fügen Sie anschließend der ThisDocument-Codedatei Code hinzu.Der neue Code verwendet das Word-Objektmodell, 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 den Zugriff auf das Word-Objektmodell bereitstellt.Weitere Informationen finden Sie unter Dokumenthostelement und Übersicht über das Word-Objektmodell.Der Rest der ThisDocument-Klasse ist in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.
Der ThisDocument_Startup-Ereignishandler und der ThisDocument_Shutdown-Ereignishandler.Diese Ereignishandler werden aufgerufen, wenn das Dokument geöffnet und geschlossen wird.Verwenden Sie diese Ereignishandler, um die Anpassung beim Öffnen des Dokuments zu initialisieren und um beim Schließen des Dokuments von der Anwendung verwendete Ressourcen zu bereinigen.Weitere Informationen finden Sie unter Ereignisse in Office-Projekten.

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

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.

Ersetzen Sie den ThisDocument_Startup-Ereignishandler durch folgenden Code.Beim Öffnen des Dokuments wird mit diesem Code dem Dokument ein zweiter Textabsatz hinzugefügt.

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub

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
In diesem Code wird der Indexwert 1 verwendet, um auf den ersten Absatz in der Paragraphs-Eigenschaft zuzugreifen.Auch wenn Visual Basic und Visual C# nullbasierte Arrays verwenden, sind die unteren Arraybegrenzungen in den meisten Auflistungen des Word-Objektmodells 1.Weitere Informationen finden Sie unter Schreiben von Code in Office-Projektmappen.

Testen des Projekts

So testen Sie das Dokument

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

Beim Erstellen des Projekts wird der Code in eine Assembly kompiliert, die mit dem Dokument verknüpft 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.
Überprüfen Sie, ob Sie im Dokument den folgenden Text sehen.

This text was added by using the designer.

This text was added by using code.
Schließen Sie das Dokument.

Bereinigen des Projekts

Wenn Sie die Entwicklung eines Projekts abgeschlossen haben, sollten Sie die Dateien im Buildausgabeordner und die durch den Buildprozess erstellten Sicherheitseinstellungen entfernen.

So bereinigen Sie das abgeschlossene Projekt auf dem Entwicklungscomputer

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, können Sie mehr über die Entwicklung von Anpassungen in den folgenden Themen erfahren:

Allgemeine Programmierungsaufgaben, die Sie in Anpassungen auf Dokumentebene ausführen können: Programmieren von Anpassungen auf Dokumentebene.
Programmieren von Aufgaben, die für Anpassungen auf Dokumentebene für Word spezifisch sind: Word-Projektmappen.
Verwenden des Word-Objektmodells: Übersicht über das Word-Objektmodell.
Anpassen der Benutzeroberfläche von Word, beispielsweise durch Hinzufügen einer benutzerdefinierten Registerkarte zum Menüband oder durch Erstellen eines eigenen benutzerdefinierten Aktionsbereichs: Anpassung der Office-Benutzeroberfläche.
Verwenden erweiterter Word-Objekte zum von Office-Projektmappen in Visual Studio bereit, um Aufgaben auszuführen, die nicht möglich sind, mit dem Word-Objektmodell verwendet (beispielsweise, verwaltete Steuerelemente in Dokumenten und und Binden an Daten über den Windows Form-Datenbindungsmodells angemeldet): Automatisieren von Word mithilfe von erweiterten Objekten.
Erstellen und Debuggen von Anpassungen auf Dokumentebene für Word: Aktualisieren von Office-Projektmappen.
Bereitstellen von Anpassungen auf Dokumentebene für Word: Bereitstellen einer Office-Projektmappe.