So senden Sie E‑Mails mit der Microsoft 365 Graph‑API in .NET‑Apps

Senden Sie eine E‑Mail in C# mit der Microsoft 365 Graph‑API

Die Integration der Microsoft‑Graph‑API in .NET‑Anwendungen ermöglicht Entwicklern, den Vorgang des Sendens von Nachrichten über Microsoft 365‑Dienste zu optimieren. Aspose.Email für .NET vereinfacht diesen Prozess und bietet erweiterte Funktionen wie Anhangsverwaltung, Tracking und sichere Kommunikation. Die Bibliothek ermöglicht es Ihnen, personalisierte, leistungsstarke E‑Mail‑Kommunikationen direkt aus Ihren .NET‑Anwendungen zu erstellen und zu versenden.

Wesentliche Vorteile der Verwendung von Aspose.Email mit Microsoft Graph

• Kein SMTP oder Basic‑Authentifizierung erforderlich – Verwenden Sie sichere, moderne tokenbasierte Authentifizierung (OAuth2).

• Microsoft 365‑ & Outlook‑Integration – Einfaches Verbinden mit Microsoft 365‑Postfächern und -Diensten.

• Enterprise‑Ready für .NET‑Entwickler – Entwickelt für Skalierbarkeit, Zuverlässigkeit und Unternehmens‑E‑Mail‑Workflows.

• Vollständig verwaltete API – keine externen Abhängigkeiten – All‑in‑One .NET‑Bibliothek, keine Graph‑SDK oder Drittanbieter‑Clients erforderlich.

• Unterstützt .NET Framework & .NET Core / .NET 6+ – Kompatibel mit modernen und älteren .NET‑Umgebungen.

• Schnelle Bereitstellung mit minimaler Konfiguration – Einfach zu nutzende API mit Beispielcode für die schnelle Implementierung.

Code‑Beispiel

Erleben Sie die Einfachheit, das Versenden von Microsoft 365‑E‑Mails in Ihre .NET‑Anwendung mit dem integrierten Graph‑Client von Aspose.Email zu integrieren.

var client = GraphClient.GetClient(authProvider);
var message = new MailMessage(...);
client.Send(message);

Wie es funktioniert

Microsoft Graph ist eine REST‑basierte Web‑API, die Zugriff auf Microsoft 365‑Dienste ermöglicht, einschließlich der Möglichkeit, E‑Mails zu senden. Beim Senden von E‑Mails über Microsoft Graph werden Anfragen mittels HTTP‑POST an den Endpunkt /sendMail zusammen mit dem Nachrichten‑Payload gesendet. Dieser Payload ist typischerweise ein JSON‑Objekt, das den Nachrichteninhalt (Empfänger, Betreff, Body usw.) und etwaige angehängte Dateien enthält.

Nach dem Empfang der Anfrage verarbeitet MS Graph diese und antwortet mit einem HTTP‑Statuscode. Ein erfolgreicher Sendevorgang liefert eine 202 Accepted‑Antwort, die anzeigt, dass die Nachricht zur Zustellung in die Warteschlange gestellt wurde. Die Behandlung dieser Antworten ermöglicht Entwicklern, die erfolgreiche Kommunikation sicherzustellen oder auftretende Probleme zu debuggen.

Authentifizierung von Microsoft Graph‑Anfragen

Der Aufruf von Microsoft Graph ist nicht so einfach wie das Senden einer HTTP‑Anfrage – Sie müssen zuerst die Authentifizierung behandeln. Die Graph‑API ist durch Azure Active Directory (Azure AD) geschützt, das bedeutet, Sie müssen ein Zugriffstoken erhalten, bevor Sie eine Anfrage stellen. Dieses Zugriffstoken gibt an, welche Vorgänge Sie ausführen dürfen, basierend auf den während des Authentifizierungsprozesses gewährten Berechtigungen.

Zur Authentifizierung müssen Sie zunächst eine App‑Registrierung in Azure AD einrichten, die erforderlichen Berechtigungen festlegen und dann ein Zugriffstoken mithilfe des entsprechenden OAuth‑Flows anfordern. Sobald Sie das Token haben, fügen Sie es in den Authorization Header Ihrer Anfragen.

Aspose.Email für .NET vereinfacht den Prozess der Beschaffung und Verwaltung des Zugriffstokens und stellt sicher, dass die Anwendung sicher mit Microsoft Graph interagieren kann. Durch die Implementierung seiner ITokenProvider Schnittstelle, Entwickler können das für die Authentifizierung erforderliche OAuth‑2.0‑Token effizient abrufen. Sobald eine App‑Registrierung im Azure‑Portal eingerichtet und die erforderlichen Berechtigungen, z. B. Mail.Send, erteilt wurden, können Entwickler die Bibliotheksfunktionen nutzen, um umfangreiche E‑Mail‑Funktionen in ihre Anwendungen zu integrieren.

Beginnen Sie mit ein paar wesentlichen Schritten:

1. Registrieren Sie Ihre Anwendung im Azure‑Portal und erteilen Sie Berechtigungen wie Mail.Send zum Senden von E‑Mails.
2. Zugriffstoken erhalten: Implementieren Sie das ITokenProvider Schnittstelle von Aspose.Email für .NET, um das für die Authentifizierung erforderliche OAuth‑2.0‑Token abzurufen.
3. Aspose.Email für .NET installieren über NuGet oder indem Sie es herunterladen DLL Datei.

Wenn Sie diesen Schritten folgen, sind Sie gut gerüstet, um mit dem Codieren zu beginnen.

Verständnis von Microsoft Graph‑Anfragen und -Antworten

Anfrage: Die Daten wie Nachrichtenthema, Body, Empfängerdetails und Anhänge werden im JSON‑Format strukturiert. Wenn die Send‑Methode aufgerufen wird, werden diese Daten serialisiert und als POST‑Anfrage an den Microsoft Graph‑/sendMail‑Endpunkt gesendet.

Antwort: Die Antwort der Graph‑API wird als Statuscode zurückgegeben. Eine 202 Accepted‑Antwort weist auf eine erfolgreiche Übertragung hin, während Fehlercodes wie 401 Unauthorized oder 403 Forbidden auf Probleme mit der Authentifizierung oder Berechtigungen hinweisen können.

Die .NET‑Bibliothek bietet integrierte Funktionen zum Erstellen, Senden von Anfragen und Parsen von Antworten bei der Interaktion mit externen Diensten wie Microsoft Graph. Diese Funktionalitäten ermöglichen es Entwicklern, die Kommunikation mit Microsoft 365‑Diensten (z. B. Outlook, Kalender, Kontakte) zu optimieren, ohne HTTP‑Anfragen manuell zu erstellen oder rohe JSON‑Antworten zu parsen.

1. Anfragen erstellen: Aspose.Email vereinfacht die Erstellung von Anfragen, indem es spezifische Klassen und Methoden bereitstellt, die die Komplexität der Anfrageerstellung abstrahieren. Entwickler können beispielsweise über intuitive APIs mit E‑Mails, Kalendern und Kontakten interagieren, ohne die erforderlichen Graph‑Anfragen manuell zu erstellen.

2. Anfragen senden: Die Bibliothek enthält integrierte Mechanismen, um Anfragen direkt an Dienste wie Microsoft Graph zu senden. Anstatt manuell mit Authentifizierung und HTTP‑Methoden zu arbeiten, übernimmt Aspose.Email den Vorgang im Hintergrund. Dazu gehört das Hinzufügen notwendiger Header wie Autorisierungstoken und Content‑Types, um sicherzustellen, dass die Anfrage korrekt formatiert ist für eine erfolgreiche Kommunikation mit Microsoft‑Diensten.

3. Antworten parsen: Mit Unterstützung für das Parsen von Antworten kann es rohe JSON‑ oder XML‑Antworten in strukturierte Objekte wie MailMessage, CalendarEvent oder Contact umwandeln. Das eliminiert die Notwendigkeit für Entwickler, JSON‑Parsing selbst zu handhaben. Die geparsten Daten können sofort innerhalb der Anwendung verwendet werden, wodurch der Integrationsprozess nahtloser und effizienter wird.

Diese Funktionen ermöglichen es Entwicklern, sich stärker auf die Geschäftslogik zu konzentrieren, anstatt die zugrunde liegenden Komplexitäten der Interaktion mit Mail‑Diensten zu verwalten.

Vollständiges C#‑Codebeispiel zum Senden von E‑Mails mit OAuth2 und Aspose.Email

Das folgende Beispiel zeigt den vollständigen Vorgang zum Senden einer E‑Mail über die Graph‑API mittels Aspose.Email für .NET. Mit wenigen Codezeilen können Sie ein OAuth2‑Zugriffstoken erzeugen, den Graph‑Client initialisieren, eine Nachricht erstellen und sie senden:

1. Erstellen Sie eine Instanz von IGraphClient durch Aufrufen von GetClient Methode.
2. Initialisieren Sie ein eml‑Objekt von MailMessage Klasse, setzen Sie deren Eigenschaften.
3. Senden Sie die Nachricht mit dem Senden Methode der Bibliothek.

using Aspose.Email;
using Aspose.Email.Clients.Graph;

// Generate the access token
AccessTokenProvider tokenProvider = new AccessTokenProvider();

// Create a Graph client
IGraphClient client = GraphClient.GetClient(tokenProvider, "tenant ID");

// Create a new message
var eml = new MailMessage(fromAddress, toAddress, subject, body);
   
// Send message
client.Send(eml);

E‑Mails mit Anhängen senden

Das Senden von E‑Mails mit Anhängen über Microsoft Graph ist mit der Aspose.Email für .NET‑Bibliothek einfach und effizient. Anhänge können jede Dateityp sein, z. B. Dokumente, Bilder oder PDFs, die zusammen mit der E‑Mail‑Nachricht gesendet werden. Dies ist besonders nützlich, um Ressourcen wie Berichte, Präsentationen oder andere wichtige Dokumente direkt über Ihre .NET‑Anwendung zu teilen.

Im folgenden Code‑Snippet werden Anhänge dem MailMessage‑Objekt hinzugefügt, bevor die E‑Mail gesendet wird:

// Add attachments to the message
Attachment attachment = new Attachment("path_to_attachment");
eml.Attachments.Add(attachment);

Wie Anhänge verarbeitet werden

1. Anhänge laden: Der Anhang wird aus dem angegebenen Dateipfad ("path_to_attachment") geladen, das kann eine lokale Datei oder ein Stream sein. Der Anhang Klasse ermöglicht das Hinzufügen jedes Dateityps als Anhang, wodurch sie sehr flexibel ist.
2. Hinzufügen zur E‑Mail: Sobald der Anhang erstellt ist, wird er zur E‑Mail‑Nachricht mit dem Attachments.Add() Methode. Diese Methode fügt die Datei zu dem MailMessage Anhangssammlung des Objekts, die automatisch enthalten ist, wenn die Nachricht über MS Graph gesendet wird.
3. E‑Mail senden: Sobald die Anhänge zur Nachricht hinzugefügt wurden, die Senden Methode aus dem IGraphClient Schnittstelle sendet die E‑Mail mit allen angehängten Dateien.

Mehrere Anhänge verarbeiten

Sie können ganz einfach mehrere Anhänge hinzufügen, indem Sie den Vorgang für jede Datei wiederholen. So fügen Sie mehr als eine Datei hinzu:

Attachment attachment1 = new Attachment("file1.pdf");
Attachment attachment2 = new Attachment("image.png");
eml.Attachments.Add(attachment1);
eml.Attachments.Add(attachment2);

Grenzen für Anhangsgrößen

Es ist wichtig zu beachten, dass Microsoft Graph Größenbeschränkungen für E‑Mail‑Nachrichten durchsetzt. Die Gesamtgröße einer E‑Mail, einschließlich Anhänge, darf 25 MB nicht überschreiten. Wenn Sie größere Dateien senden müssen, sollten Sie sie in einen Cloud‑Speicherdienst (wie OneDrive) hochladen und stattdessen den Dateilink senden.

Mehr wollen? Erkunden Sie die vollständige Microsoft‑Graph‑Unterstützung

Aspose.Email für .NET bietet eine erweiterte Microsoft 365‑Integration über die Graph‑API. Sie können außerdem:

• Ordner, Nachrichten und Entwürfe verwalten

• Mit Anhängen und Kategorien arbeiten

• Kontakte, Kalenderelemente, Notizbücher und mehr verwalten

Vollständig erkunden Microsoft‑Graph‑Funktionen.

.NET‑API installieren

Nehmen Sie sich eine Minute, um die Bibliothek in Ihr Projekt zu installieren und beginnen Sie mit dem Aufbau sicherer, skalierbarer Microsoft 365‑E‑Mail‑Lösungen mit Aspose.Email für .NET. Wählen Sie den bequemsten Weg:

• Verwenden Sie NuGet Package Manager
• Verweisen Sie auf das erforderliche Assemblies
• Oder verwenden Sie einfach den folgenden Befehl in der Package‑Manager‑Konsole von Visual Studio:

PM> Install-Package Aspose.Email