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-Tutorial Dieses Beispiel ist die fertige Version von Tutorial: Erstellen eines Excel-Aufgabenbereich-Add-Ins , das zeigt, wie ein Excel-Add-In mit einem Aufgabenbereich und Befehlsmenübandschaltflächen erstellt wird. 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 fertige Version des Outlook-Add-Ins Tutorial: 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 Sie Informationen vom Benutzer sammeln, Daten von einem externen Dienst abrufen, einen Funktionsbefehl implementieren, einen Aufgabenbereich implementieren, Inhalt in den Text einer Nachricht einfügen und ein Dialogfeld anzeigen.
PowerPoint-Tutorial (Yo Office) Dieses Beispiel ist die fertige Version von Tutorial: Erstellen eines PowerPoint-Aufgabenbereich-Add-Ins , das zeigt, wie ein PowerPoint-Add-In mit einem Aufgabenbereich erstellt wird. Das Add-In veranschaulicht das Hinzufügen eines Bilds zu einer Folie, das Hinzufügen von Text zu einer Folie, das Abrufen von Folienmetadaten und das Navigieren zwischen Folien.
PowerPoint-Tutorial (Visual Studio) Dieses Beispiel ist die fertige Version von Tutorial: Erstellen eines PowerPoint-Aufgabenbereich-Add-Ins , das zeigt, wie ein PowerPoint-Add-In mit einem Aufgabenbereich erstellt wird. Das Add-In veranschaulicht, wie Sie das Bing-Foto des Tages einer Folie hinzufügen, einer Folie Text hinzufügen, Folienmetadaten abrufen und zwischen Folien navigieren.
Word-Tutorial Dieses Beispiel ist die fertige Version von Tutorial: Erstellen eines Word Aufgabenbereich-Add-Ins, das zeigt, wie ein Word-Add-In mit einem Aufgabenbereich erstellt wird. Das Add-In veranschaulicht, wie Textbereiche, Absätze, Bilder, HTML, Tabellen und Inhaltssteuerelemente eingefügt und ersetzt werden.
Tutorial zur ersten Ausführung des Office-Add-Ins Dieses Beispiel ist die fertige Version von Erstellen eines Office-Add-Ins mit einer einfachen Ersten Ausführung , die die Grundlagen der Implementierung einer First-Run-Erfahrung (FRE) veranschaulicht. Excel wird in diesem Beispiel verwendet, aber das Muster kann auf andere Office-Anwendungen angewendet werden, in denen Office Web-Add-Ins unterstützt werden.

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
Erstellen einer Excel-Arbeitsmappe über eine Website mit einem automatisch geöffneten Aufgabenbereich Erstellen Sie mithilfe von Node.js eine Excel-Arbeitsmappe aus Websitedaten, und konfigurieren Sie sie so, dass beim Öffnen des Dokuments automatisch ein benutzerdefinierter Office-Add-In-Aufgabenbereich geöffnet wird.
Datentyp-Explorer Erstellen und untersuchen 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 Ein Inhalts-Add-In in das Excel-Raster einbetten.
Datenvisualisierung in einem Inhalts-Add-In Erstellen Sie ein Excel-Inhalts-Add-In, das Datenvisualisierung enthält.
Beispiel für synchrone benutzerdefinierte Funktionen (Vorschau) Verwenden Sie @supportSync , um eine synchrone benutzerdefinierte Funktion zu erstellen, die einen Zellwert zusammen mit dem Berechnungsprozess von Excel liest. 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 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.
Aufrufen eines Outlook-Add-Ins in einer Nachricht mit Aktionen Verwenden Sie eine adaptive Karte in einer Nachricht mit Aktionen, um ein Add-In zu aktivieren und Initialisierungskontextdaten anzuzeigen.

Word

Name Beschreibung
Automatisches Hinzufügen von Bezeichnungen mit einem Add-In, wenn ein Word Dokument geöffnet wird Konfigurieren Sie ein Word-Add-In, 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-Inhalten 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 Koersionstyp ooxml eine Vielzahl von umfangreichen 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 mit geschachtelter App-Authentifizierung Verwenden Sie MSAL.js geschachtelte App-Authentifizierung (NAA) in einem Office-Add-In, 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 Verwenden Sie MSAL.js geschachtelte App-Authentifizierung (NAA) in einem Outlook-Add-In, 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 Verwenden Sie SSO, um auf die Microsoft Graph-Daten eines Benutzers von einem Ereignis zuzugreifen, das in einem Outlook-Add-In ausgelöst wurde.
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 ein Arbeitsblatt 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 ein Arbeitsblatt 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 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.
Definieren von KeyTips für die Menübandsteuerelemente eines Office-Add-Ins Definieren sie KeyTips für Menüband-Steuerelemente eines Office-Add-Ins.

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 Sie eine freigegebene Bibliothek, um Code bei der Migration von VSTO-Add-Ins zu Office-Add-Ins wiederzuverwenden.
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 Erkunden Sie eine Sammlung von Beispielen für die Verarbeitung von DPI-Änderungen in COM-, VSTO- und Office-Add-Ins.
Aufgabenbereich-Add-In für Rubrikenbewerter für OneNote im Web Erkunden Sie die Grundlagen von OneNote-Add-Ins mit einem Beispieltool für Lehrer.

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.