Freigeben über


Erstellen eines Excel-Inhalts-Add-Ins

In diesem Artikel erfahren Sie, wie Sie mithilfe von Visual Studio ein Excel-Inhalts-Add-In erstellen.

Voraussetzungen

  • Visual Studio 2019 oder höher mit installierter Office/SharePoint-Entwicklungsumgebung.

    Hinweis

    Wenn Sie Visual Studio bereits installiert haben, verwenden Sie das Visual Studio-Installationsprogramm, um sicherzustellen, dass die Office/SharePoint-Entwicklungsumgebung installiert ist.

  • Office in Verbindung mit einem Microsoft 365-Abonnement (einschließlich Office im Internet).

Erstellen des Add-In-Projekts

  1. Wählen Sie in Visual Studio Neues Projekt erstellen.

  2. Geben Sie Add-In in das Suchfeld ein. Wählen Sie Excel-Web-Add-In und dann Weiter aus.

  3. Benennen Sie Ihr Projekt ExcelWebAddIn1, und wählen Sie Erstellen aus.

  4. Wählen Sie im Dialogfeld Office-Add-In erstellen den Add-In-TypInhalt in Excel-Kalkulationstabellen einfügen und dann Weiter aus.

  5. Wählen Sie die Add-In-Vorlage Einfaches Add-In oder Dokumentvisualisierungs-Add-In aus, und wählen Sie dann Fertig stellen aus, um das Projekt zu erstellen.

  6. Visual Studio erstellt eine Projektmappe, und die beiden Projekte werden im Projektmappen-Explorer angezeigt. Die Datei Home.html wird in Visual Studio geöffnet.

Erkunden der Visual Studio-Projektmappe

Wenn Sie den Assistenten abgeschlossen haben, erstellt Visual Studio eine Projektmappe, die zwei Projekte enthält.

Project Beschreibung
Add-In-Projekt Enthält nur eine MANIFESTdatei im XML-Format, die alle Einstellungen enthält, die Ihr Add-In beschreiben. Anhand dieser Einstellungen kann die Office-Anwendung ermitteln, wann das Add-In aktiviert und wann das Add-In angezeigt werden sollte. Visual Studio generiert die Inhalte dieser Datei für Sie, damit Sie das Projekt ausführen und das Add-In sofort verwenden können. Ändern Sie diese Einstellungen jederzeit, indem Sie die XML-Datei ändern.
Webanwendungsprojekt Enthält die Inhaltsseiten Ihres Add-Ins, darunter alle Dateien und Dateiverweise, die Sie zum Entwickeln von Office-fähigen HTML- und JavaScript-Seiten benötigen. Während Sie Ihr Add-in entwickeln, wird die Webanwendung von Visual Studio auf Ihrem lokalen IIS-Server gehostet. Sobald Sie Ihr Add-In veröffentlichen möchten, müssen Sie dieses Webanwendungsprojekt auf einem Webserver bereitstellen.

Aktualisieren des Manifests

  1. Gehen Sie im Lösungsexplorer zum Add-In-Projekt ExcelWebAddIn1 und öffnen Sie das Verzeichnis ExcelWebAddIn1Manifest. Dieses Verzeichnis beinhaltet Ihre Manifestdatei ExcelWebAddIn1.xml. Die Manifestdatei definiert die Einstellungen und Funktionen des Add-Ins. Weitere Informationen über die zwei mit Ihrer Visual Studio-Lösung erstellten Projekte finden Sie im vorherigen Abschnitt Erkunden der Visual Studio-Lösung.

  2. Das ProviderName-Element weist ein Platzhalterelement auf. Ersetzen Sie dieses nur Ihren Namen.

  3. Das DefaultValue-Attribut des DisplayName-Elements weist einen Platzhalter auf. Ersetzen Sie ihn durch Mein Office-Add-In.

  4. Das DefaultValue-Attribut des Description-Elements weist einen Platzhalter auf. Ersetzen Sie es durch ein Inhalts-Add-In für Excel.

  5. Speichern Sie die Datei. Die aktualisierten Zeilen sollten wie im folgenden Codebeispiel aussehen.

    ...
    <ProviderName>John Doe</ProviderName>
    <DefaultLocale>en-US</DefaultLocale>
    <!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
    <DisplayName DefaultValue="My Office Add-in" />
    <Description DefaultValue="A content add-in for Excel."/>
    ...
    

Probieren Sie es aus

  1. Testen Sie mithilfe von Visual Studio das neu erstellte Excel-Add-In, indem Sie F5 drücken oder die Schaltfläche Start auswählen, um Excel mit dem in der Kalkulationstabelle angezeigten Inhalts-Add-In zu starten.

  2. Stellen Sie sicher, dass das Arbeitsblatt Text enthält, und wählen Sie dann einen beliebigen Zellbereich aus, der Text im Arbeitsblatt enthält.

  3. Wählen Sie die Registerkarte für die ausgewählte Vorlage aus, und folgen Sie dann den Anweisungen.

    • Wählen Sie im Inhalts-Add-In die Schaltfläche Daten aus Auswahl abrufen aus, um den Text aus dem ausgewählten Bereich abzurufen.

      Der Add-In-Inhalt wird in Excel geöffnet.

Hinweis

Zum Anzeigen der Ausgabe console.log benötigen Sie eine separate Gruppe von Entwicklertools für eine JavaScript-Konsole. Weitere Informationen zu F12-Tools und den Microsoft Edge-DevTools finden Sie unter Debuggen von Add-Ins mithilfe von Entwicklertools für Internet Explorer, Debuggen von Add-Ins mithilfe von Entwicklertools für Microsoft Edge Legacy oder Debuggen von Add-Ins mithilfe von Entwicklertools in Microsoft Edge (Chromium-basiert).

Nächste Schritte

Herzlichen Glückwunsch, Sie haben erfolgreich ein Excel-Inhalts-Add-In erstellt! Als Nächstes, weitere Informationen zum Entwickeln eines Office-Add-Ins mit Visual Studio.

Problembehandlung

  • Wenn ihr Add-In einen Fehler anzeigt (z. B. "Dieses Add-In konnte nicht gestartet werden. Schließen Sie dieses Dialogfeld, um das Problem zu ignorieren, oder klicken Sie auf "Neu starten", um es erneut zu versuchen.) Wenn Sie F5 drücken oder Debuggen>starten in Visual Studio auswählen, finden Sie weitere Debugoptionen unter Debuggen von Office-Add-Ins in Visual Studio .

Codebeispiele

Siehe auch