Freigeben über

Anleitung: Erstellen Sie Ihre erste Dokumentanpassung für Excel

In dieser einführenden exemplarischen Vorgehensweise wird gezeigt, wie Sie eine Anpassung auf Dokumentebene für Microsoft Office Excel erstellen. Die Features, die Sie in dieser Art von Lösung erstellen, sind nur verfügbar, wenn eine bestimmte Arbeitsmappe 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 eine Arbeitsmappe geöffnet ist.

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

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines Excel-Arbeitsmappenprojekts.

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

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

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

  • Bereinigen des abgeschlossenen 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 Excel-Arbeitsmappenprojekt 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 Excel VSTO-Arbeitsmappenprojekt 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 FirstWorkbookCustomization-Projekt und fügt dem Projekt die folgenden Dateien hinzu.

    • FirstWorkbookCustomization.xlsx – Stellt die Excel-Arbeitsmappe im Projekt dar. Enthält alle Arbeitsblätter und Diagramme.

    • Sheet1 (.vb Datei für Visual Basic oder .cs Datei für Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das erste Arbeitsblatt in der Arbeitsmappe bereitstellt. Weitere Informationen finden Sie im Arbeitsblatthost-Element.

    • Sheet2 (.vb Datei für Visual Basic oder .cs Datei für Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das zweite Arbeitsblatt in der Arbeitsmappe bereitstellt.

    • Sheet3 (.vb Datei für Visual Basic oder .cs Datei für Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das dritte Arbeitsblatt in der Arbeitsmappe bereitstellt.

    • ThisWorkbook (.vb Datei für Visual Basic oder .cs Datei für Visual C#) – Enthält die Entwurfsoberfläche und den Code für Anpassungen auf Arbeitsmappenebene. Weitere Informationen finden Sie im Hostelement der Arbeitsmappe.

      Die Codedatei Sheet1 wird automatisch im Designer geöffnet.

Schließen und Erneutes Öffnen von Arbeitsblättern im Designer

Wenn Sie eine Arbeitsmappe oder ein Arbeitsblatt absichtlich oder versehentlich im Designer schließen, während Sie Ihr Projekt entwickeln, können Sie sie erneut öffnen.

So schließen und erneut öffnen Sie ein Arbeitsblatt im Designer

  1. Schließen Sie die Arbeitsmappe, 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 "Sheet1 ", und klicken Sie dann auf "Designer anzeigen".

    – oder –

    Doppelklicken Sie im Lösungs-Explorer auf die Codedatei Sheet1.

Hinzufügen von Text zu einem Arbeitsblatt im Designer

Sie können die Benutzeroberfläche Ihrer Anpassung entwerfen, indem Sie das im Designer geöffnete Arbeitsblatt ändern. Sie können beispielsweise Zellen Text hinzufügen, Formeln anwenden oder Excel-Steuerelemente hinzufügen. Weitere Informationen zur Verwendung des Designers finden Sie unter Office-Projekte in der Visual Studio-Umgebung.

So fügen Sie einem Arbeitsblatt Text mithilfe des Designers hinzu

  1. Wählen Sie in dem Arbeitsblatt, das im Designer geöffnet ist, Zelle A1 aus, und geben Sie dann den folgenden Text ein.

    Dieser Text wurde mithilfe des Designers hinzugefügt.

Warnung

Wenn Sie diese Textzeile zu Zelle A2 hinzufügen, wird sie von einem anderen Code in diesem Beispiel überschrieben.

Programmgesteuertes Hinzufügen von Text zu einem Arbeitsblatt

Fügen Sie als Nächstes der Sheet1-Codedatei Code hinzu. Der neue Code verwendet das Objektmodell von Excel, um der Arbeitsmappe eine zweite Textzeile hinzuzufügen. Standardmäßig enthält die Codedatei Sheet1 den folgenden generierten Code:

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

  • Die Sheet1_Startup und Sheet1_Shutdown Ereignishandler. Diese Ereignishandler werden aufgerufen, wenn Excel Ihre Anpassung lädt und entlädt. Verwenden Sie diese Ereignishandler, um Ihre Anpassung beim Laden zu initialisieren und um Ressourcen, die von der Anpassung verwendet werden, beim Entladen freizugeben. Weitere Informationen finden Sie unter "Ereignisse in Office-Projekten".

So fügen Sie dem Arbeitsblatt mithilfe von Code eine zweite Textzeile hinzu

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Sheet1, und klicken Sie dann auf "Code anzeigen".

    Die Codedatei wird in Visual Studio geöffnet.

  2. Ersetzen Sie den Sheet1_Startup Ereignishandler durch den folgenden Code. Wenn Sheet1 geöffnet wird, fügt dieser Code dem Arbeitsblatt eine zweite Textzeile hinzu.

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testen des Projekts

So testen Sie Ihre Arbeitsmappe

  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 der Arbeitsmappe zugeordnet ist. Visual Studio platziert eine Kopie der Arbeitsmappe und der Assembly im Buildausgabeordner für das Projekt 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. Stellen Sie in der Arbeitsmappe sicher, 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 die Arbeitsmappe.

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 Excel erstellt haben, erfahren Sie mehr über das Entwickeln von Anpassungen aus den folgenden Themen:

Verwandte Inhalte

  • Last updated on