Freigeben über

Office-Add-In-Codebeispiele

  • Artikel

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.

Blazor WebAssembly

Wenn Ihr Entwicklungshintergrund beim Erstellen von VSTO-Add-Ins liegt, zeigen die folgenden Beispiele, wie Sie Office-Web-Add-Ins mithilfe von .NET Blazor WebAssembly erstellen. Sie können einen Großteil Ihres Codes in C# und Visual Studio beibehalten.

Excel

Name Beschreibung
Datentyp-Explorer (Vorschau) Erstellt ein Excel-Add-In, mit dem Sie Datentypen in Ihren Arbeitsmappen erstellen und untersuchen können. 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.

Outlook

Name Beschreibung
Melden von Spam- oder Phishing-E-Mails in Outlook Erstellen Sie eine integrierte Spam-Berichterstellungslösung, die im Outlook-Clientmenüband 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 zur weiteren Verarbeitung in Ihrem Back-End-System in einer Datei gespeichert.
Verschlüsseln von Anlagen, Verarbeiten von Besprechungsanfragen und Reagieren auf Termindatums-/Uhrzeitänderungen mithilfe der ereignisbasierten Outlook-Aktivierung 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 Outlook-Aktivierung 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 Outlook-Aktivierung 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 der Farbkategorien einer Nachricht oder eines Termins vor dem Senden mithilfe von intelligenten Warnungen 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 die entsprechenden ausgehenden Nachrichten anzuwenden.

Word

Name Beschreibung
Abrufen, Bearbeiten und Festlegen von OOXML-Inhalten in einem Word-Dokument mit einem Word-Add-In In diesem Beispiel wird gezeigt, wie Sie OOXML-Inhalte in einem Word-Dokument abrufen, bearbeiten und festlegen. 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 Zeigt, wie Vorlagen in ein Word-Dokument importiert werden.
Open XML in Ihr Word-Add-In laden und schreiben Dieses Beispiel-Add-In zeigt, wie Sie einem Word-Dokument eine Vielzahl von umfangreichen Inhaltstypen mithilfe der setSelectedDataAsync-Methode mit ooxml-Koersionstyp hinzufügen. 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 Zeigt, wie Zitate in einem Word-Dokument verwaltet werden.

Authentifizierung, Autorisierung und Single Sign-On (SSO)

Name Beschreibung
Office-Add-In mit SSO mit geschachtelter App-Authentifizierung Zeigt, wie Sie MSAL.js geschachtelte App-Authentifizierung (NAA) in einem Office-Add-In verwenden, um auf Microsoft Graph-APIs für den angemeldeten Benutzer 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 mit geschachtelter App-Authentifizierung Zeigt, wie Sie MSAL.js geschachtelte App-Authentifizierung (NAA) in einem Outlook-Add-In verwenden, um auf Microsoft Graph-APIs für den angemeldeten Benutzer 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 Zeigt, wie Sie mithilfe von SSO auf die Microsoft Graph-Daten eines Benutzers aus einem Ereignis zugreifen, 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 Einseitenanwendung (Singe-Page Application, SPA) ohne Back-End, das eine Verbindung mit Microsoft Graph herstellt, und greifen Sie auf Arbeitsmappen zu, die in OneDrive for Business gespeichert sind, um eine Tabellenkalkulation zu aktualisieren.
Office-Add-In-Authentifizierung zu Microsoft Graph Erfahren Sie, wie Sie ein Microsoft Office-Add-In erstellen, das sich mit Microsoft Graph verbindet und auf in OneDrive for Business gespeicherte Arbeitsmappen zugreift, um eine Tabellenkalkulation zu aktualisieren.
Outlook-Add-In-Authentifizierung für Microsoft Graph. Erstellen Sie ein Outlook-Add-In, das eine Verbindung mit Microsoft Graph herstellt, und greifen Sie auf Arbeitsmappen zu, die in OneDrive for Business gespeichert sind, um eine neue E-Mail-Nachricht zu verfassen.
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 Speichern Sie benutzerdefinierte Einstellungen in einem Office-Add-In. Das Add-In speichert Daten als Schlüssel-Wert-Paare mithilfe des Eigenschaftenbehälters der JavaScript-API für Office, Browsercookies, Webspeicher (localStorage und sessionStorage) oder indem die Daten in einem ausgeblendeten div-Element im Dokument gespeichert werden.
Verwenden von Tastaturkürzeln für Office-Add-In-Aktionen Erstellen Sie benutzerdefinierte Tastenkombinationen, um bestimmte Aktionen für Ihr Office-Add-In aufzurufen.

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 Bietet eine Strategie für die 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 Eine Sammlung von Beispielen für die Handhabung von DPI-Änderungen in COM-, VSTO- und Office-Add-Ins.

Nächste Schritte

Nehmen Sie am Microsoft 365-Entwicklerprogramm teil, um Ressourcen und Informationen zu erhalten, die Ihnen helfen, Lösungen für die Microsoft 365-Plattform zu erstellen, einschließlich Empfehlungen, die auf Ihre Interessen zugeschnitten sind.

Sie können sich auch für ein kostenloses Entwicklerabonnement qualifizieren, das für 90 Tage vererbbar ist und mit Beispieldaten konfiguriert ist. Weitere Informationen finden Sie in den häufig gestellten Fragen.