Office-Add-In-Codebeispiele

Diese Codebeispiele wurden geschrieben, um Ihnen zu helfen, die Verwendung verschiedener Features bei der Entwickeln von Office-Add-Ins zu erlernen.

Erste Schritte

Die folgenden Beispiele zeigen, wie Sie eine der einfachsten Office-Add-In nur mit einem Manifest, einer HTML-Webseite und einem Logo erstellen können. Diese Komponenten sind die grundlegenden Bestandteile eines Office-Add-Ins. Weitere Informationen zu den ersten Schritten finden Sie in unseren Schnellstarts und Lernprogrammen.

Aufgabenbereich-Add-Ins

Inhalts-Add-Ins

Abgeschlossene Tutorials

Name Beschreibung
Excel-Lernprogramm Dieses Beispiel ist die abgeschlossene Version des Lernprogramms: Erstellen eines Excel-Aufgabenbereich-Add-Ins , das zeigt, wie Sie ein Excel-Add-In mit einem Aufgabenbereich und Befehlsschaltflächen im Menüband erstellen. Das Add-In veranschaulicht, wie Sie eine Tabelle erstellen und sortieren, ein Diagramm erstellen, eine Zeile fixieren, ein Arbeitsblatt schützen und ein Dialogfeld anzeigen.
Outlook-Tutorial Dieses Beispiel ist die abgeschlossene Version des Lernprogramms: Erstellen eines Outlook-Add-Ins zum Verfassen von Nachrichten , das zeigt, wie ein Outlook-Add-In für die Oberfläche zum Verfassen von Nachrichten erstellt wird. Das Add-In veranschaulicht, wie Informationen vom Benutzer gesammelt, Daten von einem externen Dienst abgerufen, ein Funktionsbefehl implementiert, ein Aufgabenfenster implementiert, Inhalt in den Nachrichtentext eingefügt und ein Dialogfeld angezeigt werden.
PowerPoint-Tutorial (Yo Office) Dieses Beispiel ist die abgeschlossene Version des Lernprogramms: Erstellen eines PowerPoint-Aufgabenbereich-Add-Ins , das zeigt, wie Sie ein PowerPoint-Add-In mit einem Aufgabenbereich erstellen. Das Add-In veranschaulicht, wie Sie einer Folie ein Bild hinzufügen, einer Folie Text hinzufügen, Folienmetadaten abrufen und zwischen Folien navigieren.
PowerPoint-Lernprogramm (Visual Studio) Dieses Beispiel ist die abgeschlossene Version des Lernprogramms: Erstellen eines PowerPoint-Aufgabenbereich-Add-Ins , das zeigt, wie Sie ein PowerPoint-Add-In mit einem Aufgabenbereich erstellen. Das Add-In veranschaulicht, wie Sie das Bing-Foto des Tages zu einer Folie hinzufügen, Text zu einer Folie hinzufügen, Folienmetadaten abrufen und zwischen Folien navigieren.
Word-Tutorial Dieses Beispiel ist die abgeschlossene Version des Lernprogramms: Erstellen eines Word-Aufgabenbereich-Add-Ins, das zeigt, wie Sie ein Word-Add-In mit einem Aufgabenbereich erstellen. Das Add-In veranschaulicht das Einfügen und Ersetzen von Textbereichen, Absätzen, Bildern, HTML-Code, Tabellen und Inhaltssteuerelementen.
Office-Add-In Tutorial zur ersten Ausführung Dieses Beispiel ist die fertige Version von Erstellen eines Office-Add-Ins mit einer grundlegenden Erstausführungserfahrung , die die Grundlagen der Implementierung einer FRE (First-Run Experience) zeigt. In diesem Beispiel wird Excel verwendet, aber das Muster kann auf andere Office-Anwendungen angewendet werden, für die Office-Web-Add-Ins unterstützt werden.

Blazor WebAssembly

Wenn Ihr Entwicklungshintergrund im Erstellen von VSTO-Add-Ins liegt, zeigen die folgenden Beispiele, wie Sie Office Web-Add-Ins mit .NET Blazor WebAssembly erstellen. Ein Großteil des Codes kann in C# und Visual Studio gespeichert werden.

Excel

Name Beschreibung
Erstellen einer Excel-Arbeitsmappe aus einer Website mit einem automatisch geöffneten Aufgabenbereich Erstellen Sie mithilfe von Node.js aus Websitedaten eine Excel-Arbeitsmappe, und konfigurieren Sie sie so, dass beim Öffnen des Dokuments automatisch ein benutzerdefinierter Office-Add-In-Aufgabenbereich geöffnet wird.
Datentypen-Explorer Erstellen und erkunden Sie Datentypen in Ihren Arbeitsmappen. Datentypen ermöglichen es Add-In-Entwicklern, komplexe Datenstrukturen als Objekte zu organisieren, z. B. formatierte Zahlenwerte, Webbilder und Entitätswerte.
In Teams öffnen Erstellen Sie eine neue Excel-Tabellenkalkulation in Microsoft Teams, welche von Ihnen definierte Daten enthält.
Einfügen einer externen Excel-Datei und Auffüllen der Datei mit JSON-Daten Fügen Sie eine vorhandene Vorlage aus einer externen Excel Datei in die aktuell geöffnete Excel Arbeitsmappe ein. Füllen Sie dann die Vorlage mit Daten aus einem JSON-Webdienst auf.
Erstellen von benutzerdefinierten kontextbezogenen Registerkarten im Menüband Erstellen Sie eine benutzerdefinierte kontextbezogene Registerkarte im Menüband auf der Office-Benutzeroberfläche. Im Beispiel wird eine Tabelle erstellt, und wenn der Benutzer den Fokus innerhalb der Tabelle verschiebt, wird die benutzerdefinierte Registerkarte angezeigt. Wenn der Benutzer sich außerhalb der Tabelle bewegt, wird die benutzerdefinierte Registerkarte ausgeblendet.
Beispiel einer benutzerdefinierten Funktion, die Web-Worker verwendet Verwenden Sie Web-Workers in benutzerdefinierten Funktionen, um das Blockieren der Benutzeroberfläche Ihres Office-Add-In zu verhindern.
Verwendung von Speichertechniken für den Zugriff auf Daten aus einem Office-Add-In, wenn offline Implementieren Sie localStorage, um limitierte Funktionalität für Ihr Office-Add-In zu aktivieren, wenn die Verbindung eines Benutzers unterbrochen wird.
Benutzerdefinierte Funktion – Batchverarbeitungsmuster Verarbeiten Sie mehrerer Aufrufe in einem einzelnen Aufruf, um die Anzahl der Netzwerkaufrufe an einen Remotedienst zu reduzieren.
Excel-Inhalts-Add-In Betten Sie ein Inhalts-Add-In in das Excel-Raster ein.
Datenvisualisierung in einem Inhalts-Add-In Erstellen Sie ein Excel-Inhalts-Add-In, das Datenvisualisierung enthält.
Beispiel für eine synchrone benutzerdefinierte Funktion (Vorschau ) Verwenden Sie diese Funktion zum @supportSync Erstellen einer synchronen benutzerdefinierten Funktion, die einen Zellwert zusammen mit dem Berechnungsprozess von Excel liest. Diese Funktion befindet sich in einem öffentlichen Vorschauzustand.
Skill für Copilot in Excel (Vorschau ) Erstellen Sie eine benutzerdefinierte Fähigkeit für Copilot in Excel, die die Excel-spezifischen APIs in der Office JavaScript-Bibliothek verwendet. Diese Funktion befindet sich in einem öffentlichen Vorschauzustand.

Outlook

Name Beschreibung
Verschlüsseln und Entschlüsseln von Nachrichten in Outlook Verwenden Sie Outlook Smart Alerts und das OnMessageDecrypt Ereignis, um Nachrichten zu verschlüsseln und zu entschlüsseln.
Melden von Spam- oder Phishing-E-Mails in Outlook Erstellen Sie eine integrierte Spamberichterstattung, die im Menüband des Outlook-Clients leicht erkennbar ist. Die Lösung stellt dem Benutzer ein Dialogfeld zum Melden einer E-Mail bereit. Außerdem wird eine Kopie der gemeldeten E-Mail in einer Datei zur weiteren Verarbeitung in Ihrem Backend-System gespeichert.
Verschlüsseln von Anlagen, Verarbeiten von Teilnehmern von Besprechungsanfragen und Reagieren auf Änderungen von Termindatum/-uhrzeit mithilfe der ereignisbasierten Aktivierung von Outlook Verwenden Sie die ereignisbasierte Aktivierung, um Anlagen zu verschlüsseln, wenn sie vom Benutzer hinzugefügt werden. Verwenden Sie außerdem das Ereignishanding für Empfänger, die in einer Besprechungsanfrage geändert wurden, und für Änderungen des Start- oder Enddatums oder der Uhrzeit in einer Besprechungsanfrage.
Identifizieren und Markieren externer Empfänger mithilfe der ereignisbasierten Aktivierung von Outlook Verwenden Sie die ereignisbasierte Aktivierung, um ein Outlook-Add-In auszuführen, wenn der Benutzer während dem Verfassen einer Nachricht die Empfänger ändert. Das Add-In verwendet auch die appendOnSendAsync-API, um einen Haftungsausschluss hinzuzufügen.
Festlegen Ihrer Signatur mithilfe der ereignisbasierten Aktivierung in Outlook Verwenden Sie die ereignisbasierte Aktivierung, um ein Outlook-Add-In auszuführen, wenn der Benutzer eine neue Nachricht oder einen Termin erstellt. Das Add-In kann auf Ereignisse reagieren, auch wenn der Aufgabenbereich nicht geöffnet ist. Außerdem wird die setSignatureAsync-API verwendet.
Überprüfen Sie mithilfe von Smart Alerts die Farbkategorien einer Nachricht oder eines Termins, bevor sie gesendet wird Verwenden Sie intelligente Outlook-Warnungen, um vor dem Senden zu überprüfen, ob erforderliche Farbkategorien auf eine neue Nachricht oder einen neuen Termin angewendet wurden.
Überprüfen der Vertraulichkeitsbezeichnung einer Nachricht Verwenden Sie die Vertraulichkeitsbezeichnungs-API in einem ereignisbasierten Add-In, um die Vertraulichkeitsbezeichnung "Streng vertraulich " zu überprüfen und auf anwendbare ausgehende Nachrichten anzuwenden.
Aufrufen eines Outlook-Add-Ins in einer Nachricht mit Aktionen Verwenden Sie eine adaptive Karte in einer Handlungsnachricht, um ein Add-In zu aktivieren und Initialisierungskontextdaten anzuzeigen.

Word

Name Beschreibung
Automatisches Hinzufügen von Bezeichnungen mit einem Add-In beim Öffnen eines Word-Dokuments Konfigurieren eines Word-Add-Ins, das beim Öffnen eines Dokuments aktiviert wird.
Abrufen, Bearbeiten und Festlegen von OOXML-Inhalten in einem Word-Dokument mit einem Word-Add-In Abrufen, Bearbeiten und Festlegen von OOXML-Inhalt in einem Word-Dokument. Das Beispiel-Add-In bietet ein Scratchpad, um Office Open XML für Ihre eigenen Inhalte abzurufen und Ihre eigenen bearbeiteten Office Open XML-Codeausschnitte zu testen.
Importieren einer Word-Dokumentvorlage mit einem Word-Add-In Importieren von Vorlagen in ein Word-Dokument.
Open XML in Ihr Word-Add-In laden und schreiben Fügen Sie einem Word-Dokument mithilfe der setSelectedDataAsync-Methode mit dem ooxml-Koerzierungstyp eine Vielzahl umfangreicher Inhaltstypen hinzu. Das Add-In bietet Ihnen auch die Möglichkeit, das Office Open XML-Markup für jeden Beispielinhaltstyp direkt auf der Seite anzuzeigen.
Verwalten von Zitaten mit Ihrem Word-Add-In Verwalten von Zitaten in einem Word-Dokument.

Authentifizierung, Autorisierung und Single Sign-On (SSO)

Name Beschreibung
Office-Add-In mit SSO unter Verwendung geschachtelter App-Authentifizierung Verwenden Sie MSAL.js geschachtelte App-Authentifizierung (NAA) in einem Office-Add-In, um für den angemeldeten Benutzer auf Microsoft Graph-APIs zuzugreifen. Im Beispiel werden der Name und die E-Mail-Adresse des angemeldeten Benutzers angezeigt. Außerdem werden die Namen von Dateien aus dem Microsoft OneDrive-Konto des Benutzers in das Dokument eingefügt.
Outlook-Add-In mit SSO unter Verwendung geschachtelter App-Authentifizierung Verwenden Sie MSAL.js geschachtelte App-Authentifizierung (Nested App Authentication, NAA) in einem Outlook-Add-In, um für den angemeldeten Benutzer auf Microsoft Graph-APIs zuzugreifen. Im Beispiel werden der Name und die E-Mail-Adresse des angemeldeten Benutzers angezeigt. Außerdem werden die Namen von Dateien aus dem Microsoft OneDrive-Konto des Benutzers in einen neuen Nachrichtentext eingefügt.
Verwenden von SSO mit ereignisbasierter Aktivierung in einem Outlook-Add-In Verwenden Sie SSO, um auf die Microsoft Graph-Daten eines Benutzers aus einem Ereignis zuzugreifen, das in einem Outlook-Add-In ausgelöst wird.
Beispiel für Single Sign-On (SSO) – Outlook-Add-In Verwenden Sie das SSO-Feature von Office, um dem Add-In Zugriff auf Microsoft Graph-Daten zu gewähren.
Abrufen von OneDrive-Daten mithilfe von Microsoft Graph und msal.js in einem Office-Add-In Erstellen Sie ein Office-Add-In als Single-Page-Anwendung (SPA) ohne Back-End, das eine Verbindung mit Microsoft Graph herstellt, um auf in OneDrive for Business gespeicherte Arbeitsmappen zuzugreifen und eine Kalkulationstabelle zu aktualisieren.
Office-Add-In-Authentifizierung zu Microsoft Graph Erstellen Sie ein Microsoft Office-Add-In, das eine Verbindung mit Microsoft Graph herstellt, um auf in OneDrive for Business gespeicherte Arbeitsmappen zuzugreifen und eine Kalkulationstabelle zu aktualisieren.
Outlook-Add-In-Authentifizierung bei Microsoft Graph Erstellen Sie ein Outlook-Add-In, das eine Verbindung mit Microsoft Graph herstellt, um auf in OneDrive for Business gespeicherte Arbeitsmappen zuzugreifen und eine neue E-Mail-Nachricht zu erstellen.
Single Sign-On (SSO)-Office-Add-In mit ASP.NET Verwenden Sie die getAccessToken-API in Office.js, um dem Add-In Zugriff auf Microsoft Graph Daten zu gewähren. Dieses Beispiel basiert auf ASP.NET.
Single Sign-On (SSO)-Office-Add-In mit Node.js Verwenden Sie die getAccessToken-API in Office.js, um dem Add-In Zugriff auf Microsoft Graph Daten zu gewähren. Dieses Beispiel basiert auf Node.js.

Office

Name Beschreibung
Speichern benutzerdefinierter Einstellungen in Ihrem Office-Add-In Benutzerdefinierte Einstellungen in einem Office-Add-In speichern. Das Add-In speichert Daten als Schlüssel-Wert-Paare mithilfe der JavaScript-API für den Office-Eigenschaftenbereich, Browser-Cookies, Webspeicher (localStorage und sessionStorage) oder durch Speichern der Daten in einem versteckten div-Element im Dokument.
Verwenden von Tastaturkürzeln für Office-Add-In-Aktionen Erstellen Sie benutzerdefinierte Tastenkombinationen, um bestimmte Aktionen für Ihr Office-Add-In aufzurufen.
Definieren von Tasteninfos für die Menübandsteuerelemente eines Office-Add-Ins Definieren von Tasteninfos für Menübandsteuerelemente eines Office-Add-Ins.
Ein- oder Ausblenden von Steuerelementen auf einer benutzerdefinierten Registerkarte des Menübands Legen Sie die anfängliche Sichtbarkeit von Gruppen und Steuerelementen auf einer benutzerdefinierten Office-Add-In-Registerkarte fest, und ändern Sie ihre Sichtbarkeit zur Laufzeit.

Freigegebene Runtime

Name Beschreibung
Freigeben globaler Daten mit einer freigegebenen Runtime Richten Sie ein einfaches Projekt ein, das die freigegebene Runtime verwendet, um Code für Menübandschaltflächen, den Aufgabenbereich und benutzerdefinierte Funktionen in einer einzigen Browserruntime auszuführen.
Verwalten des Menübandes und der Aufgabenbereich-Benutzeroberfläche, und Code auf einem offenen Dokument ausführen Erstellen Sie kontextbezogene Menübandschaltflächen, die basierend auf dem Status des Add-Ins aktiviert sind.

Zusätzliche Beispiele

Name Beschreibung
Verwenden einer freigegebenen Bibliothek zum Migrieren Ihres Visual Studio-Tools für Office-Add-Ins zu einem Office-Web-Add-In Verwenden einer freigegebenen Bibliothek zur Wiederverwendung von Code bei der Migration von VSTO-Add-Ins zu Office-Add-Ins.
Integrieren einer Azure-Funktion in Ihre benutzerdefinierte Excel-Funktion Integrieren Sie Azure-Funktionen in benutzerdefinierte Funktionen, um in die Cloud zu wechseln oder zusätzliche Dienste zu integrieren.
Beispiele für dynamischen DPI-Code Sehen Sie sich eine Sammlung von Beispielen für die Handhabung von DPI-Änderungen in COM-, VSTO- und Office-Add-Ins an.
Rubrikenkorrektur-Aufgabenbereich-Add-In für OneNote im Web Erkunden Sie die Grundlagen von OneNote-Add-Ins anhand eines Beispieltools für Lehrer.

Nächste Schritte

Treten Sie dem Microsoft 365 Developer Program bei und erhalten Sie Ressourcen und Informationen, die Ihnen bei der Entwicklung von Lösungen für die Microsoft 365-Plattform helfen, einschließlich Empfehlungen, die auf Ihre Interessengebiete zugeschnitten sind.

Möglicherweise haben Sie auch Anspruch auf ein kostenloses Entwicklerabonnement, das um 90 Tage verlängert werden kann und mit Beispieldaten konfiguriert ist. Weitere Informationen finden Sie in den FAQ.

  • Last updated on