Senden von HTML-Emails aus dem ASP-.-NET-Core mit FluentEmail (Deutsch (German))

Senden von HTML-Emails aus dem ASP-.-NET-Core mit FluentEmail

Wednesday, 07 August 2024

//

5 minute read

Dies ist ein ziemlich einfacher Artikel, aber wird einige der odness der Verwendung decken FluentEmail in ASP-.-NET Core, um HTML E-Mails zu senden Ich habe nicht anderswo gesehen

Das Problem

Das Senden von HTML-Mails ist selbst eine Art einfache mit SmtpClient.,, aber es ' ist nicht sehr flexibel und unterstützt Dinge wie Vorlagen oder Anhänge nicht .. FluentEmail ist eine großartige Bibliothek für dieses...,.

FluentEmail mit Razorlight (-it-' built in-) , ermöglicht es Ihnen, Ihre E-Mails mit Hilfe von Razors Syntax zu templatieren Dies ist großartig, da es Ihnen erlaubt, die volle Leistung von Rasor verwenden, um Ihre e-Mails zu erstellen

Die Lösung

Zuerst müssen Sie die FluentEmail Installieren , um . ,Core , , , Fluent Email ,. , Smtp , & , fluentEMail ,. , Razor Bibliotheken , : ,

dotnet add package FluentEmail.Core
dotnet add package FluentEmail.Smtp
dotnet add package FluentEmail.Razor

Einrichtung von FluentEmail

Um die Dinge getrennt zu halten, habe ich dann eine IServiceCollection-Erweiterung erstellt, welche die FluentEmail Dienste einrichtet.

namespace Mostlylucid.Email;

public static class Setup
{
    public static void SetupEmail(this IServiceCollection services, IConfiguration config)
    {
          var smtpSettings = services.ConfigurePOCO<SmtpSettings>(config.GetSection(SmtpSettings.Section));

        services.AddFluentEmail(smtpSettings.SenderEmail, smtpSettings.SenderName)
            .AddRazorRenderer();

        services.AddSingleton<ISender>(new SmtpSender( () => new SmtpClient()
        {
            DeliveryMethod = SmtpDeliveryMethod.Network,
            Host = smtpSettings.Server,
            Port = smtpSettings.Port,
            Credentials = new NetworkCredential(smtpSettings.Username, smtpSettings.Password),
            EnableSsl = smtpSettings.EnableSSL,
            UseDefaultCredentials = false
        }));
        services.AddSingleton<EmailService>();
        
    }

}

Einstellungen für ##-SMTP

Wie Sie sehen, habe ich auch die IConfigSection Methode verwendet, die in meinem vorheriger Artikel um die SMTP-Einstellungen zu erhalten

  var smtpSettings = services.ConfigurePOCO<SmtpSettings>(config.GetSection(SmtpSettings.Section));

Das kommt von der Appsettings-Datei ..json.

"SmtpSettings":
  {
    "Server": "smtp.gmail.com",
    "Port": 587,
    "SenderName": "Mostlylucid",
    "Username": "",
    "SenderEmail": "[email protected]",
    "Password": "",
    "EnableSSL": "true",
    "EmailSendTry": 3,
    "EmailSendFailed": "true",
    "ToMail": "[email protected]",
    "EmailSubject": "Mostlylucid"
    
  }

GMAIL Google SMTP

Hinweis: Für Google SMTP, wenn Sie MFA verwenden *wirklich sollten Sie müssen ein machen App-Passwort für Ihr Konto.

Für lokale dev-,- können Sie dies zu Ihren Geheimnissen hinzufügen.

secrets.png

Docker einrichten

Für docker komponieren verwenden Sie normalerweise enthalten Sie dies in einer Datei :

SMTPSETTINGS_USERNAME="[email protected]"
SMTPSETTINGS_PASSWORD="<MFA PASSWORD>" -- this is the app password you created

Dann in der docker komponieren Datei injizieren Sie diese als env-Variablen

services:
  mostlylucid:
    image: scottgal/mostlylucid:latest
    ports:
      - 8080:8080
    environment:
      - SmtpSettings__UserName=${SMTPSETTINGS_USERNAME}
      - SmtpSettings__Password=${SMTPSETTINGS_PASSWORD}

Nehmen Sie eine Notiz vom Abstand, da dies kann wirklich verwirren Sie mit docker komponieren ?. , um zu überprüfen, was ? ' injiziert können Sie verwenden

docker compose config

Um Ihnen zu zeigen, wie die Datei aussieht mit diesen injizierten

FluentEmail-Anfechtungen

Ein Problem mit Fluent Email ist, dass Sie diese zu Ihrem csproj hinzufügen müssen

  <PropertyGroup>
    <PreserveCompilationContext>true</PreserveCompilationContext>
  </PropertyGroup>

Dies liegt daran, dass FluentEmail RazorLight verwendet, die diese benötigt, um zu arbeiten.

Für die Template-Dateien können Sie sie entweder als Content-Dateien in Ihr Projekt einbinden oder wie ich es im Docker-Container tue, die Dateien auf das endgültige Bild kopieren.

FROM build AS publish
RUN dotnet publish "Mostlylucid.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app

COPY --from=publish /app/publish .
# Copy the Markdown directory
COPY ./Mostlylucid/Markdown /app/Markdown
COPY ./Mostlylucid/Email/Templates /app/Email/Templates
# Switch to a non-root user
USER $APP_UID

E-Mail-Dienst

Okay zurück zum Code

Jetzt haben wir es alles eingerichtet, können wir die E-Mail-Service hinzufügen.Dies ist ein einfacher Dienst, der eine Vorlage nimmt und sendet eine e-Mail.

public class EmailService(SmtpSettings smtpSettings, IFluentEmail fluentEmail)
{
    public async Task SendCommentEmail(string commenterEmail, string commenterName, string comment, string postSlug)
    {
        var commentModel = new CommentEmailModel
        {
            PostSlug = postSlug,
            SenderEmail = commenterEmail,
            SenderName = commenterName,
            Comment = comment
        };
        await SendCommentEmail(commentModel);
    }

    public async Task SendCommentEmail(CommentEmailModel commentModel)
    {
        // Load the template
        var templatePath = "Email/Templates/MailTemplate.template";
        await SendMail(commentModel, templatePath);
    }

    public async Task SendContactEmail(ContactEmailModel contactModel)
    {
        var templatePath = "Email/Templates/ContactEmailModel.template";

        await SendMail(contactModel, templatePath);
    }


    public async Task SendMail(BaseEmailModel model, string templatePath)
    {
        var template = await File.ReadAllTextAsync(templatePath);
        // Use FluentEmail to send the email
        var email = fluentEmail.UsingTemplate(template, model);
        await email.To(smtpSettings.ToMail)
            .SetFrom(smtpSettings.SenderEmail, smtpSettings.SenderName)
            .Subject("New Comment")
            .SendAsync();
    }
}

Wie Sie hier sehen können, haben wir zwei Methoden eine für Kommentare und eine für das KontaktformularSenden Sie mir eine Mail. In dieser App mache ich Sie sich einloggen, so dass ich die E-Mail es erhalten kann, ' s aus und Spam zu vermeiden

Wirklich die meisten der Arbeit ist hier getan

 var template = await File.ReadAllTextAsync(templatePath);
        // Use FluentEmail to send the email
        var email = fluentEmail.UsingTemplate(template, model);
        await email.To(smtpSettings.ToMail)
            .SetFrom(smtpSettings.SenderEmail, smtpSettings.SenderName)
            .Subject("New Comment")
            .SendAsync();

Hier öffnen wir eine Template-Datei, um das Modell mit dem Inhalt für die E-Mail, laden Sie es in FluentEmail und dann senden Sie es .. . Die Vorlage ist eine einfache Razor-Datei

@model Mostlylucid.Email.Models.ContactEmailModel

<!DOCTYPE html>
<html class="dark">
<head>
    <title>Comment Email</title>
</head>
<body>
<h1>Comment Email</h1>
<p>New comment from email @Model.SenderEmail name @Model.SenderName</p>

<p>Thank you for your comment on our blog post. We appreciate your feedback.</p>
<p>Here is your comment:</p>
<div>
    @Raw( @Model.Comment)</div>
<p>Thanks,</p>
<p>The Blog Team</p>

</body>
</html>

Diese werden als .-Template-Dateien im E-Mail-Ordner gespeichert.." Sie können .Cshtml-Dateien verwenden, aber es verursacht ein Problem mit dem "MSC4"-Raw-Tag in der Vorlage.(.it' ist eine Rasiererlicht Sache.

Der Controller

Schließlich kommen wir zum Controller es ist wirklich ziemlich einfach.

    [HttpPost]
    [Route("submit")]
    [Authorize]
    public async Task<IActionResult> Submit(string comment)
    {
        var user = GetUserInfo();
            var commentHtml = commentService.ProcessComment(comment);
            var contactModel = new ContactEmailModel()
            {
                SenderEmail = user.email,
                SenderName =user.name,
                Comment = commentHtml,
            };
            await emailService.SendContactEmail(contactModel);
            return PartialView("_Response", new ContactViewModel(){Email = user.email, Name = user.name, Comment = commentHtml, Authenticated = user.loggedIn});

        return RedirectToAction("Index", "Home");
    }

Hier erhalten wir die Benutzer-Info, um den Kommentar zu bearbeiten. Ich benutze einen einfachen Markdown Prozessor mit Markdig, um Markdown in HTML zu konvertieren und dann die Email zu senden.

Finding related posts...
logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.