Intégration de MailKit avec le service de transmission de messages

Utilisez MailKit pour envoyer des courriels au moyen du service de transmission de messages.

Configurer MailKit pour l'envoi de courriels au moyen du service de transmission de messages

MailKit est un cadre de messagerie multiplateforme open source pour les applications .NET. Comme SmtpClient n'est plus une approche suggérée pour l'envoi de courriels dans les applications .NET, vous pouvez utiliser MailKit pour envoyer et recevoir des courriels au moyen du service de transmission de messages. Avant d'utiliser MailKit, configurez un exemple de code MailKit et testez-le avec la configuration du service de transmission de messages.

Important

Les instructions suivantes contiennent un exemple de code pour votre commodité et doivent être utilisées comme référence.

Pour configurer l'exemple de code MailKit et tester la configuration du service de transmission de messages :

  1. Assurez-vous que le service de courriel est configuré pour l'envoi de courriel. Voir Introduction.

    Note

    Les données d'identification SMTP sont requises pour configurer MailKit afin qu'elles puissent utiliser le service de transmission de messages. Veuillez noter le nom d'utilisateur et le mot de passe lorsque vous générez les données d'identification SMTP.

  2. Pour créer un projet dans Visual Studio Code :

    1. Créez un espace de projet en créant un dossier nommé OCIEmail.
    2. Ouvrez le dossier OCIEmail dans Fichier de code VS > Ouvrir le dossier.
    3. Ouvrez la fenêtre du terminal (ctrl + ~).
    4. Pour créer le modèle de projet et ajouter la dépendance de MailKit, exécutez les commandes suivantes dans le terminal.
      dotnet new console --framework net6.0
      dotnet add package MailKit --version 2.15.0 

      Développez votre projet dans la fenêtre VS Code Explorer.

  3. Remplacez le contenu du fichier Program.cs par le bloc de code suivant :
    using System;
    
    using MailKit.Net.Smtp;
    using MailKit;
    using MimeKit;
    
    namespace Program {
        class TestOCIEmail
        {
            public static void Main (string[] args)
            {
                var message = new MimeMessage ();
                message.From.Add (new MailboxAddress ("<FROM NAME>", "<FROM>"));
                message.To.Add (new MailboxAddress ("<TO NAME>", "<TO>"));
                message.Subject = "Mail from OCI ED service";
    
                message.Body = new TextPart ("Html") {
                    Text = @"
                    <h1>OCI Email Delivery test</h1>
                    <p>This email was sent with OCI Email Delivery using the 
                    <a href='https://github.com/jstedfast/MailKit'>MailKit Package</a>
                    for .Net .</p>"
                };
    
                using (var client = new SmtpClient ()) {
    
                    var host = "<HOST>";
                    var port = 587;
                    var username = "<smtp username>";
                    var password = "<smtp password>";
                    
                    client.Connect (host, port, false);
    
                    client.Authenticate (username, password);
    
                    client.Send (message);
                    client.Disconnect (true);
                }
               Console.WriteLine("Email send successfully !!");
            }
        }
    }
    
  4. Remplacez les paramètres suivants par vos propres valeurs dans le fichier Program.cs :
    1. FROM (De) - Remplacez la valeur par l'adresse de courriel de votre expéditeur. Assurez-vous que cette adresse de courriel est ajoutée à la liste Émetteurs approuvés du service de transmission de messages.
    2. TO (À) - Remplacez la valeur par l'adresse de courriel du destinataire.
    3. SMTP credentials (Données d'identification SMTP) - Remplacez les valeurs de smtp_username et de smtp_password par votre nom d'utilisateur et votre mot de passe SMTP générés dans la console pour Oracle Cloud Infrastructure.
    4. HOST - Remplacez la valeur par le point d'extrémité SMTP du service de transmission de messages. Par exemple, smtp.us-ashburn-1.oraclecloud.com.
  5. Enregistrez les modifications et exécutez la commande suivante pour envoyer le courriel :
    dotnet run
  6. Vérifiez la sortie. Si le courriel a été envoyé, la console l'affiche. Sinon, un message d'erreur s'affiche.
  7. Connectez-vous à la boîte de réception du destinataire afin de vérifier la réception du courriel.