Freigeben über


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

Aktualisiert: Juli 2008

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Dokumentebene

Microsoft Office-Version

  • Word 2007

  • Word 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

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 Multifunktionsleisten-Registerkarte, wenn ein beliebiges Dokument geöffnet ist.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines Word-Dokumentprojekts für Word 2003 oder Word 2007

  • 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:

  • Visual Studio Tools for Office (eine optionale Komponente von Visual Studio 2008 Professional und Visual Studio Team System).

  • Word 2003 oder Word 2007.

Visual Studio Tools for Office wird standardmäßig mit den aufgeführten Versionen von Visual Studio installiert. Wie Sie überprüfen können, ob die Software installiert ist, erfahren Sie in Installieren von Visual Studio Tools for Office.

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. Erweitern Sie im Bereich Projekttypen den Knoten Visual C# oder Visual Basic, und erweitern Sie dann Office.

  4. Wählen Sie den Ordner 2007, wenn Sie eine Anpassung für Word 2007 entwickeln, oder wählen Sie den Ordner 2003, wenn Sie eine Anpassung für Word 2003 entwickeln.

    Hinweis:

    Wenn Sie eine Anpassung auf Dokumentebene für eine bestimmte Word-Version entwickeln, muss diese Version auf Ihrem Entwicklungscomputer installiert sein.

  5. Wählen Sie im Bereich VorlagenWord 2003-Dokument oder Word 2007-Dokument aus.

  6. Geben Sie im Feld Name den Namen FirstDocumentCustomization ein.

  7. Klicken Sie auf OK.

    Der Projekt-Assistent aus Visual Studio Tools for Office wird geöffnet.

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

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

  2. 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 Übersicht über Office-Dokumente 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 Visual Studio Tools for Office-Projektereignisse.

So fügen Sie mit Code dem Dokument 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 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 Programmieren mit Visual Basic im Vergleich zu C#.

Testen des Projekts

So testen Sie das Dokument

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

  2. Ü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.

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

Siehe auch

Konzepte

Übersicht über die Entwicklung von Office-Projektmappen

Entwicklung von Anpassungen auf Dokumentebene für Word

Programmieren von Anpassungen auf Dokumentebene

Übersicht über das Word-Objektmodell

Automatisieren von Word mithilfe von erweiterten Objekten

Anpassung der Office-Benutzeroberfläche

Übersicht über Visual Studio Tools for Office-Projektvorlagen

Referenz

Word-Dokument-Projektvorlage

Weitere Ressourcen

Erstellen und Debuggen von Office-Projektmappen

Bereitstellen von Office-Projektmappen

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

Juli 2008

Thema hinzugefügt.

Informationsergänzung.