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
Wählen Sie in Visual Studio Neues Projekt erstellen.
Geben Sie Add-In in das Suchfeld ein. Wählen Sie Excel-Web-Add-In und dann Weiter aus.
Benennen Sie Ihr Projekt ExcelWebAddIn1, und wählen Sie Erstellen aus.
Wählen Sie im Dialogfeld Office-Add-In erstellen den Add-In-TypInhalt in Excel-Kalkulationstabellen einfügen und dann Weiter aus.
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.
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
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.
Das
ProviderName
-Element weist ein Platzhalterelement auf. Ersetzen Sie dieses nur Ihren Namen.Das
DefaultValue
-Attribut desDisplayName
-Elements weist einen Platzhalter auf. Ersetzen Sie ihn durch Mein Office-Add-In.Das
DefaultValue
-Attribut desDescription
-Elements weist einen Platzhalter auf. Ersetzen Sie es durch ein Inhalts-Add-In für Excel.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
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.
Stellen Sie sicher, dass das Arbeitsblatt Text enthält, und wählen Sie dann einen beliebigen Zellbereich aus, der Text im Arbeitsblatt enthält.
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.
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
Stellen Sie sicher, dass Ihre Umgebung für die Office-Entwicklung bereit ist, indem Sie die Anweisungen unter Einrichten Ihrer Entwicklungsumgebung befolgen.
Einige des Beispielcodes verwenden ES6-JavaScript. Dies ist nicht kompatibel mit älteren Versionen von Office, die das Trident (Internet Explorer 11)-Browsermodul verwenden. Informationen zur Unterstützung dieser Plattformen in Ihrem Add-In finden Sie unter Unterstützen älterer Microsoft-Webviews und Office-Versionen. Wenn Sie noch nicht über ein Microsoft 365-Abonnement für die Entwicklung verfügen, können Sie sich über das Microsoft 365-Entwicklerprogramm für ein Microsoft 365 E5 Entwicklerabonnement qualifizieren. Weitere Informationen finden Sie in den häufig gestellten Fragen. Alternativ können Sie sich für eine kostenlose 1-monatige Testversion registrieren oder einen Microsoft 365-Plan erwerben.
- 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
Office Add-ins