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

Artikel
02/26/2013

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

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Excel 2013 und Excel 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 Excel-Arbeitsmappenprojekts
Hinzufügen von Text zu einem in Visual Studio Designer gehosteten Arbeitsblatt
Schreiben von Code, der das Excel-Objektmodell zum Hinzufügen von Text zu einem angepassten Arbeitsblatt beim Öffnen des Arbeitsblatts verwendet
Erstellen und Ausführen des Projekts zum Testen
Bereinigen des abgeschlossenen 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).

Excel 2013 oder Excel 2010.

Erstellen des Projekts

So erstellen Sie ein neues Excel-Arbeitsmappenprojekt 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 Excel 2010-Arbeitsmappe oder Excel 2013-Arbeitsmappe aus.
Geben Sie im Feld Name den Namen FirstWorkbookCustomization 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 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 bei Visual Basic, CS-Datei bei Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das erste Arbeitsblatt in der Arbeitsmappe angibt.Weitere Informationen finden Sie unter Arbeitsblatthostelement.
- Sheet2 (VB-Datei bei Visual Basic, CS-Datei bei Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das zweite Arbeitsblatt in der Arbeitsmappe angibt.
- Sheet3 (VB-Datei bei Visual Basic, CS-Datei bei Visual C#) – Ein Arbeitsblatt, das die Entwurfsoberfläche und den Code für das dritte Arbeitsblatt in der Arbeitsmappe angibt.
- ThisWorkbook (VB-Datei bei Visual Basic, CS-Datei bei Visual C#) – Enthält die Entwurfsoberfläche und den Code für Anpassungen auf Arbeitsmappenebene.Weitere Informationen finden Sie unter Arbeitsmappenhostelement.
Die Sheet1-Codedatei wird automatisch im Designer geöffnet.

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

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

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

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

- oder -

Doppelklicken Sie im Projektmappen-Explorer auf die Codedatei Sheet1.

Hinzufügen von Text zu einem Arbeitsblatt im Designer

Sie können die Benutzeroberfläche Ihrer Anpassung gestalten, indem Sie das geöffnete Arbeitsblatt im Designer ändern.Zum Beispiel können Sie Text zu Zellen hinzufügen, Formeln übernehmen 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 mit dem Designer einem Arbeitsblatt Text hinzu

Wählen Sie im geöffneten Arbeitsblatt die Zelle A1 aus, und geben Sie anschließend den folgenden Text ein.

This text was added by using the designer.

Vorsicht
Wenn Sie diese Textzeile zur Zelle A2 hinzufügen, wird sie von anderem Code aus diesem Beispiel überschrieben.

Programmgesteuertes Hinzufügen von Text zu einem Arbeitsblatt

Fügen Sie anschließend der Sheet1-Codedatei Code hinzu.Der neue Code verwendet das Excel-Objektmodell, um der Arbeitsmappe eine zweite Textzeile hinzuzufügen.Standardmäßig enthält die Sheet1-Codedatei 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 finden Sie unter Arbeitsblatthostelement und Übersicht über das Word-Objektmodell.Der Rest der Sheet1-Klasse ist in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.
Der Sheet1_Startup-Ereignishandler und der Sheet1_Shutdown-Ereignishandler.Diese Ereignishandler werden aufgerufen, wenn Excel die Anpassung lädt und entlädt.Verwenden Sie diese Ereignishandler, um die Anpassung zu initialisieren, wenn sie geladen wird, und um beim Entladen die Ressourcen zu bereinigen, die von der Anpassung verwendet werden.Weitere Informationen finden Sie unter Ereignisse in Office-Projekten.

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

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.

Ersetzen Sie den Sheet1_Startup-Ereignishandler durch folgenden Code.Beim Öffnen von Sheet1 wird mit diesem Code dem Arbeitsblatt eine zweite Textzeile hinzugefügt.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
    nr.Value2 = "This text was added by using code"
End Sub

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

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 der Arbeitsmappe verknüpft 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 Aktualisieren von Office-Projektmappen.
Überprüfen Sie, ob Sie in der Arbeitsmappe den folgenden Text sehen.

This text was added by using the designer.

This text was added by using code.
Schließen Sie die Arbeitsmappe.

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 Excel 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 Excel spezifisch sind: Excel-Projektmappen.
Verwenden des Excel-Objektmodells: Übersicht über das Excel-Objektmodell.
Anpassen der Benutzeroberfläche von Excel, 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 Office-Entwicklungstools in Visual Studio bereitgestellten erweiterten Excel-Objekte zum Ausführen von Aufgaben, die mit dem Excel-Objektmodell nicht möglich sind (z. B. Hosten verwalteter Steuerelemente in Dokumenten und Binden von Excel-Steuerelementen an Daten mit dem Datenbindungsmodell von Windows Forms): Automatisieren von Excel mithilfe von erweiterten Objekten.
Erstellen und Debuggen von Anpassungen auf Dokumentebene für Excel: Aktualisieren von Office-Projektmappen.
Bereitstellen von Anpassungen auf Dokumentebene für Excel: Bereitstellen einer Office-Projektmappe.