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

Artikel
08/10/2011

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 2007 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

Tipp

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 2010, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.100\).md).

Word 2007 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 Visual C# oder Visual Basic, und erweitern Sie dann Office.
Wählen Sie unter dem erweiterten Knoten Office die Option 2007 aus, wenn Sie Word 2007 installiert haben, oder wählen Sie den Knoten 2010 aus, wenn Sie Word 2010 haben.
Wählen Sie in der Liste der Projektvorlagen Word 2007-Dokument oder Word 2010-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 unter Ü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 hierzu 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.";
}
```
Tipp

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 Programmieren mit Visual Basic und Visual C# 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 hierzu finden Sie unter Übersicht über das Erstellen 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 der von Visual Studio Tools for Office bereitgestellten erweiterten Word-Objekte zum Ausführen von Aufgaben, die mit dem Word-Objektmodell nicht möglich sind (z. B. Hosten verwalteter Steuerelemente in Dokumenten und Binden von Word-Steuerelementen an Daten mit dem Datenbindungsmodell von Windows Forms): Automatisieren von Word mithilfe von erweiterten Objekten.
Erstellen und Debuggen von Anpassungen auf Dokumentebene für Word: Erstellen und Debuggen von Office-Projektmappen.
Bereitstellen von Anpassungen auf Dokumentebene für Word: Bereitstellen von Office-Projektmappen.