Exemplarische Vorgehensweise: Erstellen des ersten Add-Ins auf Anwendungsebene für Excel

Artikel
02/26/2013

In dieser einführenden exemplarischen Vorgehensweise wird erläutert, wie Sie ein Add-In auf Anwendungsebene für Microsoft Office Excel erstellen.Die Features, die Sie in dieser Art von Projektmappe erstellen, sind für die Anwendung selbst verfügbar, unabhängig davon, welche Arbeitsmappen geöffnet sind.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene 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-Add-In-Projekt für Excel
Schreiben von Code, der das Excel-Objektmodell zum Hinzufügen von Text zu einer Arbeitsmappe beim Speichern verwendet
Erstellen und Ausführen des Projekts zum Testen
Bereinigen des abgeschlossenen Projekts, damit das Add-In nicht mehr automatisch auf dem Entwicklungscomputer ausgeführt wird

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 Add-In-Projekt für Excel 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-Add-In oder Excel 2013-Add-In aus.
Geben Sie im Feld Name die Zeichenfolge FirstExcelAddIn ein.
Klicken Sie auf OK.

Visual Studio erstellt das Projekt FirstExcelAddIn und öffnet die ThisAddIn-Codedatei im Editor.

Schreiben von Code zum Hinzufügen von Text zur gespeicherten Arbeitsmappe

Fügen Sie anschließend der ThisAddIn-Codedatei Code hinzu.Der neue Code verwendet das Excel-Objektmodell, um in der ersten Zeile des aktiven Arbeitsblatts Textbausteine einzufügen.Das aktive Arbeitsblatt ist das Arbeitsblatt, das geöffnet ist, wenn der Benutzer die Arbeitsmappe speichert.Standardmäßig enthält die ThisAddIn-Codedatei den folgenden generierten Code:

Eine partielle Definition der ThisAddIn-Klasse.Diese Klasse liefert einen Einstiegspunkt für den Code und ermöglicht den Zugriff auf das Excel-Objektmodell.Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.Der Rest der ThisAddIn-Klasse ist in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.
Der ThisAddIn_Startup-Ereignishandler und der ThisAddIn_Shutdown-Ereignishandler.Diese Ereignishandler werden aufgerufen, wenn das Add-In von Excel geladen und entladen wird.Verwenden Sie diese Ereignishandler, um das Add-In zu initialisieren, wenn es geladen wird, und um beim Entladen die Ressourcen zu bereinigen, die vom Add-In verwendet werden.Weitere Informationen finden Sie unter Ereignisse in Office-Projekten.

So fügen Sie der gespeicherten Arbeitsmappe eine Textzeile hinzu

Fügen Sie in der ThisAddIn-Codedatei der ThisAddIn-Klasse folgenden Code hinzu.Der neue Code definiert einen Ereignishandler für das WorkbookBeforeSave-Ereignis, das beim Speichern einer Arbeitsmappe ausgelöst wird.

Wenn der Benutzer eine Arbeitsmappe speichert, fügt der Ereignishandler neuen Text am Anfang des aktiven Arbeitsblatts hinzu.

Private Sub Application_WorkbookBeforeSave(ByVal Wb As Microsoft.Office.Interop.Excel.Workbook, ByVal SaveAsUI As Boolean, ByRef Cancel As Boolean) Handles Application.WorkbookBeforeSave
    Dim activeWorksheet As Excel.Worksheet = CType(Application.ActiveSheet, Excel.Worksheet)
    Dim firstRow As Excel.Range = activeWorksheet.Range("A1")
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown)
    Dim newFirstRow As Excel.Range = activeWorksheet.Range("A1")
    newFirstRow.Value2 = "This text was added by using code"
End Sub

void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

Wenn Sie C# verwenden, fügen Sie den folgenden Code dem ThisAddIn_Startup-Ereignishandler hinzu:Dieser Code wird verwendet, um den Application_WorkbookBeforeSave-Ereignishandler mit dem WorkbookBeforeSave-Ereignis zu verbinden.
```
this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);
```

Um die Arbeitsmappe beim Speichern zu ändern, werden in den vorherigen Codebeispielen die folgenden Objekte verwendet:

Das Application-Feld der ThisAddIn-Klasse.Das Application-Feld gibt ein Microsoft.Office.Interop.Excel.Application-Objekt zurück, das die aktuelle Instanz von Excel darstellt.
Der Wb-Parameter des Ereignishandlers für das WorkbookBeforeSave-Ereignis.Der Wb-Parameter ist ein Microsoft.Office.Interop.Excel.Workbook-Objekt, das die gespeicherte Arbeitsmappe darstellt.Weitere Informationen finden Sie unter Übersicht über das Excel-Objektmodell.

Testen des Projekts

So testen Sie das Projekt

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

Beim Erstellen des Projekts wird der Code in eine Assembly kompiliert, die in den Buildausgabeordner für das Projekt aufgenommen wird.Visual Studio erstellt auch einen Satz von Registrierungseinträgen, die es Excel ermöglichen, das Add-In aufzufinden und zu laden, und konfiguriert die Sicherheitseinstellungen auf dem Entwicklungscomputer, damit das Add-In ausgeführt werden kann.Weitere Informationen finden Sie unter Aktualisieren von Office-Projektmappen.
Speichern Sie die Arbeitsmappe in Excel.
Überprüfen Sie, ob der folgende Text der Arbeitsmappe hinzugefügt wurde.

This text was added by using code.
Beenden Sie Excel.

Bereinigen des Projekts

Wenn Sie die Entwicklung eines Projekts abgeschlossen haben, entfernen Sie die Add-In-Assembly, die Registrierungseinträge und die Sicherheitseinstellungen vom Entwicklungscomputer.Andernfalls wird das Add-In jedes Mal ausgeführt, wenn Sie Excel auf dem Entwicklungscomputer öffnen.

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 ein grundlegendes Add-In auf Anwendungsebene für Excel erstellt haben, können Sie mehr über die Entwicklung von Add-Ins in den folgenden Themen erfahren:

Allgemeine Programmierungsaufgaben, die Sie in Add-Ins ausführen können: Programmieren von Add-Ins auf Anwendungsebene.
Programmierungsaufgaben, die für Excel-Add-Ins 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 Aufgabenbereichs: Anpassung der Office-Benutzeroberfläche.
Erstellen und Debuggen von Add-Ins auf Anwendungsebene für Excel: Aktualisieren von Office-Projektmappen.
Bereitstellen von Add-Ins auf Anwendungsebene für Excel: Bereitstellen einer Office-Projektmappe.