Novely.Tools.Emails 2.0.0

Novely.Tools.Emails

Service d'envoi d'e-mails via SMTP pour .NET 8.0, basé sur MailKit.

Installation

dotnet add package Novely.Tools.Emails

Configuration

Enregistrer le service via l'injection de dépendances :

builder.Services.AddEmailService(new EmailSettings
{
    Server = "smtp.exemple.com",
    Port = 465,
    Sender = "noreply@exemple.com",
    UseCredentials = true,
    User = "utilisateur",
    Password = "motdepasse"
});

Proprietes de EmailSettings

Les adresses multiples sont separees par ;.

Utilisation

Injecter IEmailService puis appeler SendEmail :

public class MonService(IEmailService emailService)
{
    public void EnvoyerNotification()
    {
        emailService.SendEmail(
            subject: "Bienvenue",
            body: "<h1>Bonjour</h1><p>Votre compte est actif.</p>",
            recipient: "destinataire@exemple.com"
        );
    }
}

Envoyer avec des pieces jointes

var fichiers = new List<EmailFile>
{
    new("rapport.pdf", pdfBytes),
    new("image.png", imageBytes, new ContentType("image", "png"))
};

emailService.SendEmail(
    subject: "Rapport mensuel",
    body: "<p>Veuillez trouver le rapport en piece jointe.</p>",
    recipient: "destinataire@exemple.com",
    attachments: fichiers
);

Envoyer avec copie carbone (CC)

emailService.SendEmail(
    recipient: "destinataire@exemple.com",
    subject: "Mise a jour",
    body: "<p>Information importante.</p>",
    recipientCc: "copie@exemple.com"
);

Envoyer un MimeMessage personnalise

Pour un controle total, construire un MimeMessage et l'envoyer directement :

var message = new MimeMessage();
message.From.Add(new MailboxAddress("Expediteur", "noreply@exemple.com"));
message.To.Add(new MailboxAddress("Destinataire", "contact@exemple.com"));
message.Subject = "Sujet personnalise";
message.Body = new TextPart("html") { Text = "<p>Contenu</p>" };

emailService.SendEmail(message);

Mode pickup directory

En definissant PickupDirectoryLocation, les e-mails sont sauvegardes en fichiers .eml dans le dossier indique au lieu d'etre envoyes via SMTP. Utile pour le developpement et les tests :

new EmailSettings
{
    Sender = "noreply@exemple.com",
    PickupDirectoryLocation = "/tmp/emails"
};

Licence

MIT