Freigeben über

Walkthrough: Create your first document-level customization for Excel

  • Artikel

Diese exemplarische Vorgehensweise bietet eine Einführung zum Erstellen einer Anpassung auf Dokumentebene für Microsoft Office Excel. Die Features, die Sie in dieser Art von Projektmappe erstellen, sind nur verfügbar, wenn eine bestimmte Arbeitsmappe geöffnet ist. Sie können eine Anpassung auf Dokumentebene nicht verwenden, um anwendungsweite Änderungen vorzunehmen, z. B., um eine neue Registerkarte des Menübands anzuzeigen, 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 features available by Office-App lication and project type.

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 Excel-Objektmodell zum Hinzufügen von Text zum angepassten Arbeitsblatt verwendet, wenn dieses geöffnet wird.

  • Erstellen Sie das Projekt, und führen Sie es aus, um es zu testen.

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

    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

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Projekts

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. Klicken Sie 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 Den 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 Arbeitsblatthostelement.

    • 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 Arbeitsmappenhostelement.

      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 das Projekt entwickeln, können Sie sie bzw. es erneut öffnen.

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

  1. Schließen Sie die Arbeitsmappe, indem Sie auf die Schaltfläche "Schließen " (X) für das Designerfenster klicken.

  2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf die Codedatei "Sheet1", und klicken Sie auf "Designer anzeigen".

    - oder -

    Doppelklicken Sie in Projektmappen-Explorer auf die Codedatei Sheet1.

Hinzufügen von Text zu einem Arbeitsblatt im Designer

Sie können die Benutzeroberfläche (User Interface, UI) Ihrer Anpassung gestalten, indem Sie das im Designer geöffnete Arbeitsblatt ändern. Beispielsweise können Sie 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 mithilfe des Designers Text 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

Als Nächstes fügen Sie der Codedatei "Sheet1" Code hinzu. Der neue Code verwendet das Excel-Objektmodell, 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 den Zugriff auf das Excel-Objektmodell bereitstellt. Weitere Informationen: Übersicht über das Arbeitsblatthostelement und das Word-Objektmodell. Der Rest der Sheet1 -Klasse ist in einer ausgeblendeten Codedatei definiert, die nicht geändert werden darf.

  • Die Ereignishandler Sheet1_Startup und Sheet1_Shutdown . Diese Ereignishandler werden aufgerufen, wenn Ihre Anpassung von Excel geladen und entladen wird. Verwenden Sie diese Ereignishandler zum Initialisieren der Anpassung, wenn sie geladen wird, und zum Bereinigen der von der Anpassung verwendeten Ressourcen, wenn sie entladen wird. 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 in 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. Beim Öffnen von "Sheet1" wird dem Arbeitsblatt durch diesen Code eine zweite Textzeile hinzugefügt.

    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 die Arbeitsmappe

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

    Wenn Sie das Projekt erstellen, wird der Code in eine Assembly kompiliert, die der Arbeitsmappe zugeordnet ist. Visual Studio legt eine Kopie der Arbeitsmappe 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 Erstellen von Office-Lösungen.

  2. Vergewissern Sie sich, dass der folgende Text in der Arbeitsmappe angezeigt wird.

    Dieser Text wurde mithilfe des Designers hinzugefügt.

    Dieser Text wurde per Code hinzugefügt.

  3. Schließen Sie die Arbeitsmappe.

Bereinigen des Projekts

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

  • Allgemeine Programmieraufgaben, die Sie in Anpassungen auf Dokumentebene ausführen können: Programmanpassungen auf Dokumentebene.

  • Programmieraufgaben, die spezifisch für Anpassungen auf Dokumentebene für Excel sind: Excel-Lösungen.

  • Verwenden des Objektmodells von Excel: Übersicht über das Excel-Objektmodell.

  • Anpassen der Benutzeroberfläche von Excel, z. B. durch Hinzufügen einer benutzerdefinierten Registerkarte zum Menüband oder Erstellen eines eigenen Aktionsbereichs: Anpassung der Office-Benutzeroberfläche.

  • Verwenden erweiterter Excel-Objekte, die von Office-Entwicklungstools in Visual Studio bereitgestellt werden, um Aufgaben auszuführen, die nicht mithilfe des Excel-Objektmodells möglich sind (z. B. hosten verwaltete Steuerelemente in Dokumenten und Binden von Excel-Steuerelementen an Daten mithilfe des Windows Forms-Datenbindungsmodells): Automatisieren Sie Excel mithilfe erweiterter Objekte.

  • Erstellen und Debuggen von Anpassungen auf Dokumentebene für Excel: Erstellen von Office-Lösungen.

  • Bereitstellen von Anpassungen auf Dokumentebene für Excel: Bereitstellen einer Office-Lösung.

Zugehöriger Inhalt