Sendgrid .NET (So funktioniert es für Entwickler)

SendGrid, Teil von Twilio SendGrid, bietet einen Cloud-basierten Service, der Kunden hilft, E-Mails einfach zu versenden und Kommunikationsprozesse zu optimieren. Wenn Sie ein SendGrid-Konto erstellen, erhalten Sie Zugang zu Funktionen wie SMTP-Relay und API-Schlüssel. Es ermöglicht einen effizienten Versand von E-Mail-Nachrichten. Das SMTP-Relay ist das Herzstück dieses Prozesses, da es dafür sorgt, dass Ihre E-Mails von Ihrem Server über das System von SendGrid gesendet werden. Die Funktion "Authentifizierte Domäne" verifiziert Ihre Domäne. Da SendGrid Open Source ist, können Sie auf das GitHub-Repositorium zugreifen und bei der Anpassung helfen.

In diesem Leitfaden möchten wir Ihnen die Merkmale und Funktionen von SendGrid .NET näher bringen und Sie durch die Ersteinrichtung, die grundlegenden Vorgänge und die fortgeschrittenen Funktionen führen. Ganz gleich, ob Sie Ihre erste E-Mail über Code versenden oder Ihre E-Mail-Kampagnen optimieren möchten, dieser Artikel ist Ihr Ausgangspunkt für die Beherrschung von SendGrid .NET und seiner Integration mit IronPDF.

Erste Schritte mit SendGrid .NET

Zunächst müssen Sie SendGrid .NET in Ihrem Projekt einrichten. Installieren Sie zunächst das SendGrid .NET-Paket. Verwenden Sie dazu NuGet Package Manager. Öffnen Sie Visual Studio und dann die Paketmanager-Konsole. Geben Sie den folgenden Befehl ein:

Install-Package SendGrid

Dieser Befehl fügt SendGrid zu Ihrem Projekt hinzu. Richten Sie nach der Installation Ihr SendGrid-Konto ein. Sie benötigen einen API-Schlüssel. Gehen Sie zum SendGrid-Website. Erstellen Sie ein Konto, wenn Sie noch keines haben. Wenn Sie angemeldet sind, navigieren Sie zu Einstellungen. Suchen API-Schlüssel. Klicken Sie auf API-Schlüssel erstellen. Geben Sie ihm einen Namen und wählen Sie die Zugriffsstufe. Kopieren Sie den API-Schlüssel. Sie werden dies in Ihrer Bewerbung verwenden.

Grundlegendes Code-Beispiel

Schicken wir also eine E-Mail. Erstellen Sie eine neue Instanz des SendGridClient. Übergeben Sie Ihren API-Schlüssel an den Konstruktor. Erstellen Sie dann eine SendGridMessage. Legen Sie die E-Mail-Adressen von Absender und Empfänger fest. Fügen Sie einen Betreff und den Inhalt der E-Mail hinzu. Verwenden Sie schließlich SendGridClient, um die Nachricht zu versenden. Hier ist ein einfaches Beispiel:

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Hello World from SendGrid",
    PlainTextContent = "This is a test email.",
    HtmlContent = "<strong>This is a test email.</strong>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Hello World from SendGrid",
    PlainTextContent = "This is a test email.",
    HtmlContent = "<strong>This is a test email.</strong>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

Dim client = New SendGridClient("your_api_key")
Dim message = New SendGridMessage() With {
	.From = New EmailAddress("your_email@example.com", "Your Name"),
	.Subject = "Hello World from SendGrid",
	.PlainTextContent = "This is a test email.",
	.HtmlContent = "<strong>This is a test email.</strong>"
}
message.AddTo(New EmailAddress("recipient_email@example.com", "Recipient Name"))
Dim response = Await client.SendEmailAsync(message)

Dieser Code sendet eine einfache E-Mail. Es zeigt die Grundlagen der Verwendung von SendGrid .NET. Von hier aus können Sie weitere Funktionen nutzen.

Implementierungsfunktionen von SendGrid .NET

Versenden von E-Mails mit benutzerdefiniertem HTML-Inhalt

Um eine E-Mail mit HTML-Inhalt zu versenden, erstellen Sie zunächst Ihr HTML. Verwenden Sie dann SendGridMessage, um HtmlContent zu setzen. Damit können Sie umfangreiche E-Mails gestalten. So geht's:

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Custom HTML Content",
    HtmlContent = "<html><body><h1>This is a Heading</h1><p>This is a paragraph.</p></body></html>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

var client = new SendGridClient("your_api_key");
var message = new SendGridMessage()
{
    From = new EmailAddress("your_email@example.com", "Your Name"),
    Subject = "Custom HTML Content",
    HtmlContent = "<html><body><h1>This is a Heading</h1><p>This is a paragraph.</p></body></html>"
};
message.AddTo(new EmailAddress("recipient_email@example.com", "Recipient Name"));
var response = await client.SendEmailAsync(message);

Dim client = New SendGridClient("your_api_key")
Dim message = New SendGridMessage() With {
	.From = New EmailAddress("your_email@example.com", "Your Name"),
	.Subject = "Custom HTML Content",
	.HtmlContent = "<html><body><h1>This is a Heading</h1><p>This is a paragraph.</p></body></html>"
}
message.AddTo(New EmailAddress("recipient_email@example.com", "Recipient Name"))
Dim response = Await client.SendEmailAsync(message)

SendGrid SMTP-Dienst verwenden

Manchmal ziehen Sie vielleicht SMTP vor, um E-Mails zu versenden. SendGrid unterstützt dies ebenfalls. Konfigurieren Sie Ihre SMTP-Einstellungen in SendGrid. Verwenden Sie dann diese Einstellungen in Ihrer Anwendung. Diese Methode erfordert das Einrichten eines SMTP-Clients mit den Serverdaten von SendGrid. Hier ist eine Grundeinstellung:

var client = new SmtpClient("smtp.sendgrid.net")
{
    Port = 587,
    Credentials = new NetworkCredential("apikey", "your_sendgrid_apikey"),
    EnableSsl = true,
};
var mailMessage = new MailMessage
{
    From = new MailAddress("your_email@example.com"),
    Subject = "Test SMTP Email",
    Body = "This is a test email sent via SMTP.",
    IsBodyHtml = true,
};
mailMessage.To.Add("recipient_email@example.com");
client.Send(mailMessage);

var client = new SmtpClient("smtp.sendgrid.net")
{
    Port = 587,
    Credentials = new NetworkCredential("apikey", "your_sendgrid_apikey"),
    EnableSsl = true,
};
var mailMessage = new MailMessage
{
    From = new MailAddress("your_email@example.com"),
    Subject = "Test SMTP Email",
    Body = "This is a test email sent via SMTP.",
    IsBodyHtml = true,
};
mailMessage.To.Add("recipient_email@example.com");
client.Send(mailMessage);

Dim client = New SmtpClient("smtp.sendgrid.net") With {
	.Port = 587,
	.Credentials = New NetworkCredential("apikey", "your_sendgrid_apikey"),
	.EnableSsl = True
}
Dim mailMessage As New MailMessage With {
	.From = New MailAddress("your_email@example.com"),
	.Subject = "Test SMTP Email",
	.Body = "This is a test email sent via SMTP.",
	.IsBodyHtml = True
}
mailMessage.To.Add("recipient_email@example.com")
client.Send(mailMessage)

Verwalten von E-Mail-Kampagnen

SendGrid .NET ermöglicht die Verwaltung von E-Mail-Kampagnen. Erstellen, versenden und verfolgen Sie Kampagnen über die API. Detaillierte Informationen zum Kampagnenmanagement finden Sie in der API-Dokumentation von SendGrid. Diese Funktion geht über den reinen E-Mail-Versand hinaus, ist aber für Marketingzwecke sehr nützlich.

Umgang mit abgelehnten E-Mails und Spam-Berichten

Der Umgang mit Bounces und Spam-Meldungen ist entscheidend. SendGrid .NET bietet Webhooks für diese Ereignisse. Richten Sie Webhooks in Ihrem SendGrid-Dashboard ein. Verarbeiten Sie dann diese Ereignisse in Ihrer Anwendung. So bleibt Ihre E-Mail-Liste sauber und die Zustellbarkeit wird verbessert.

Authentifizierung von Domains

Die Domänenauthentifizierung ist wichtig für die Zustellbarkeit von E-Mails. Damit wird der Besitz Ihrer Domain überprüft. Richten Sie in SendGrid die Domain-Authentifizierung über das Dashboard ein. Dazu müssen DNS-Einträge hinzugefügt werden. Einmal verifizierte E-Mails erscheinen den Empfängern und E-Mail-Anbietern vertrauenswürdiger.

IronPDF mit SendGrid integrieren

Einführung von IronPDF

IronPDF ist eine Bibliothek, mit der Entwickler PDF-Inhalte in .NET-Anwendungen erstellen, bearbeiten und extrahieren können. Es bietet einen unkomplizierten Ansatz für den programmatischen Umgang mit PDF-Dateien. Es erleichtert die Arbeit mit PDF-Dateien, ohne dass tiefgreifende Kenntnisse der PDF-Spezifikationen erforderlich sind. Mit IronPDF können Entwickler hTML in PDF konvertieren, bestehende PDFs bearbeiten und Inhalte extrahieren.

Anwendungsfall der Zusammenführung von IronPDF mit SendGrid C#

In einer Geschäftsanwendung müssen Finanzberichte, Rechnungen oder personalisierte Dokumente dynamisch erstellt und per E-Mail an Kunden oder andere Beteiligte gesendet werden. Mit IronPDF können diese Dokumente aus Vorlagen oder Datenquellen erstellt und in das PDF-Format konvertiert werden. Anschließend können diese PDF-Dokumente mit Hilfe des C#-Clients von SendGrid an E-Mails angehängt und automatisch an die vorgesehenen Empfänger versandt werden.

IronPDF-Bibliothek installieren

Um IronPDF zu verwenden, müssen Sie zunächst das NuGet-Paket installieren. Öffnen Sie zunächst die NuGet Package Manager-Konsole und führen Sie dann diesen Befehl aus:

Install-Package IronPdf

Codebeispiel eines Anwendungsfalls mit Details und Schritten

Schritt 1: PDF-Erzeugung mit IronPDF

Zunächst erzeugen wir ein PDF-Dokument. Als Beispiel erstellen wir eine einfache PDF-Datei aus einem HTML-String.

using IronPdf;
var Renderer = new HtmlToPdf();
var PDF = Renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
var outputPath = "example.pdf";
PDF.SaveAs(outputPath);

using IronPdf;
var Renderer = new HtmlToPdf();
var PDF = Renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
var outputPath = "example.pdf";
PDF.SaveAs(outputPath);

Imports IronPdf
Private Renderer = New HtmlToPdf()
Private PDF = Renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
Private outputPath = "example.pdf"
PDF.SaveAs(outputPath)

Schritt 2: SendGrid einrichten

Stellen Sie sicher, dass Sie das SendGrid NuGet-Paket installiert haben:

Install-Package SendGrid

Dann konfigurieren Sie SendGrid in Ihrer Anwendung. Sie benötigen einen API-Schlüssel von Ihrem SendGrid-Konto.

using SendGrid;
using SendGrid.Helpers.Mail;
var apiKey = "your_sendgrid_api_key";
var client = new SendGridClient(apiKey);

using SendGrid;
using SendGrid.Helpers.Mail;
var apiKey = "your_sendgrid_api_key";
var client = new SendGridClient(apiKey);

Imports SendGrid
Imports SendGrid.Helpers.Mail
Private apiKey = "your_sendgrid_api_key"
Private client = New SendGridClient(apiKey)

Schritt 3: E-Mail mit PDF-Anhang erstellen und versenden

Erstellen Sie nun eine E-Mail-Nachricht und hängen Sie die zuvor erstellte PDF-Datei an. Senden Sie schließlich die E-Mail über SendGrid.

var from = new EmailAddress("your_email@example.com", "Your Name");
var subject = "Sending with SendGrid is Fun";
var to = new EmailAddress("recipient_email@example.com", "Recipient Name");
var plainTextContent = "Hello, Email!";
var htmlContent = "<strong>Hello, Email!</strong>";
var msg = MailHelper.CreateSingleEmail(from, to, subject, plainTextContent, htmlContent);
// Attach the PDF
var bytes = File.ReadAllBytes(outputPath);
var file = Convert.ToBase64String(bytes);
msg.AddAttachment("example.pdf", file);
var response = await client.SendEmailAsync(msg);

var from = new EmailAddress("your_email@example.com", "Your Name");
var subject = "Sending with SendGrid is Fun";
var to = new EmailAddress("recipient_email@example.com", "Recipient Name");
var plainTextContent = "Hello, Email!";
var htmlContent = "<strong>Hello, Email!</strong>";
var msg = MailHelper.CreateSingleEmail(from, to, subject, plainTextContent, htmlContent);
// Attach the PDF
var bytes = File.ReadAllBytes(outputPath);
var file = Convert.ToBase64String(bytes);
msg.AddAttachment("example.pdf", file);
var response = await client.SendEmailAsync(msg);

Dim from = New EmailAddress("your_email@example.com", "Your Name")
Dim subject = "Sending with SendGrid is Fun"
Dim [to] = New EmailAddress("recipient_email@example.com", "Recipient Name")
Dim plainTextContent = "Hello, Email!"
Dim htmlContent = "<strong>Hello, Email!</strong>"
Dim msg = MailHelper.CreateSingleEmail(from, [to], subject, plainTextContent, htmlContent)
' Attach the PDF
Dim bytes = File.ReadAllBytes(outputPath)
Dim file = Convert.ToBase64String(bytes)
msg.AddAttachment("example.pdf", file)
Dim response = Await client.SendEmailAsync(msg)

Dieses Codebeispiel veranschaulicht die Erstellung eines einfachen PDF-Dokuments, das Anhängen an eine E-Mail und den Versand über SendGrid. Es ist ein unkomplizierter Prozess, der die Dokumentenerstellung und die E-Mail-Funktionen von IronPDF und SendGrid in eine .NET-Anwendung integriert.

Schlussfolgerung

Abschließend bietet dieser Leitfaden einen umfassenden Überblick über die Integration von SendGrid .NET für E-Mail-Dienste und IronPDF für die Verwaltung von PDF-Dokumenten in .NET-Anwendungen. Wenn Sie die beschriebenen Schritte befolgen, können Entwickler E-Mail-Versandfunktionen mit anpassbaren HTML-Inhalten und SMTP-Serviceoptionen effizient implementieren und E-Mail-Kampagnen verwalten.

Darüber hinaus ermöglicht die Integration von IronPDF die dynamische Generierung und den E-Mail-Versand von PDF-Dokumenten, wie z. B. Finanzberichte oder Rechnungen, was einen praktischen Anwendungsfall für die Zusammenführung dieser leistungsstarken Bibliotheken darstellt. Entwickler, die diese Funktionalitäten erforschen möchten, können sich die kostenloser Test von IronPDF, bevor Sie sich für eine Lizenz entscheiden. Lizenz die Kosten beginnen bei 749 $.