AIDE .NET

C# Imap (Comment ça marche pour les développeurs)

Publié avril 3, 2024

Dans le domaine de la communication entre serveurs de courrier électronique, le protocole d'accès aux messages Internet (Internet Message Access Protocol)(IMAP) joue un rôle crucial en facilitant l'accès aux messages électroniques stockés sur un serveur de messagerie. L'intégration de la nouvelle fonctionnalité des serveurs IMAP du Framework .NET dans les applications C# permet aux développeurs de créer des clients de messagerie robustes, d'automatiser les tâches de traitement du courrier électronique et d'améliorer la productivité. Ce guide complet explore les principes fondamentaux de l'intégration du protocole IMAP en C#, couvrant les concepts clés, les techniques d'implémentation IMAP, l'extension idle, et des exemples de code pratiques pour aider les développeurs à exploiter la puissance des clients IMAP dans leurs applications. Ce guide explique également comment créer des fichiers PDF à l'aide deIronPDF - une bibliothèque C# robuste pour la génération et la manipulation de PDF etFonctionnalité IMAP en C# de Rebex données.

1. Comprendre le client IMAP

IMAP est un protocole largement utilisé pour accéder et gérer les messages électroniques stockés sur un serveur de messagerie distant. Contrairement à l'ancien protocole POP3, qui télécharge les messages électroniques vers un client de messagerie local et les retire ensuite du serveur de messagerie, les serveurs IMAP permettent aux utilisateurs de visualiser le premier message, d'organiser et de manipuler les messages électroniques directement sur le serveur. Cela permet de synchroniser les courriels sur plusieurs appareils et d'adopter une approche plus souple de la gestion des courriels.

2. Principales caractéristiques de l'IMAP

Synchronisation des messages : IMAP permet aux clients de synchroniser les messages électroniques, les dossiers et l'état des boîtes aux lettres avec le serveur, ce qui garantit un accès constant aux dernières données de messagerie à partir de n'importe quel appareil.
Gestion des dossiers : IMAP prend en charge la création, le renommage, la suppression et l'organisation de dossiers de courrier électronique sur le serveur, ce qui permet aux utilisateurs de classer leurs messages dans des catégories logiques.
Récupération et manipulation des messages : Avec IMAP, les clients peuvent récupérer, rechercher, lire, déplacer, copier et supprimer des messages électroniques individuels ou des fils de discussion entiers directement à partir du serveur.
Marquage et mise à jour de l'état des courriels : IMAP permet aux clients de marquer les messages, de les marquer comme lus ou non lus, et de gérer les indicateurs de messages tels que "vu", "répondu" ou "marqué", ce qui permet un meilleur contrôle de l'état des courriels.

3. Mise en œuvre du serveur IMAP dans le C# ;

Pour intégrer la fonctionnalité IMAP dans les applications C#, les développeurs peuvent s'appuyer sur des bibliothèques tierces telles que MailKit ou OpenPop.NET, qui offrent une prise en charge complète des opérations IMAP. Examinons un exemple simple d'utilisation de MailKit pour connecter un utilisateur à un serveur IMAP, récupérer des messages électroniques et effectuer des opérations de base.

Avant de passer à l'exemple de code, il y a quelques étapes à suivre pour obtenir le mot de passe de l'application qui est nécessaire pour utiliser le serveur IMAP afin d'accéder à vos courriels.

Accédez à votre compte Gmail et cliquez sur Paramètres.
Dans les paramètres, allez dans la section IMAP et activez les cases à cocher suivantes.
Ensuite, accédez à votre compte Google et recherchez la vérification en deux étapes.
Dans la page de vérification en deux étapes, descendez jusqu'à la fin et trouvez le mot de passe de l'application.
Ensuite, écrivez le nom de votre application et cliquez sur le bouton Créer.
Le mot de passe de l'application a été généré avec succès.
Une fois les configurations effectuées et le mot de passe de l'application créé, plongeons dans le code.

//Install-Package MailKit
using System;
using MailKit.Net.Imap;
using MailKit.Search;
using MimeKit;
class Program
{
    static void Main(string [] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;
        // IMAP credentials
        string username = "buttwaleed121@gmail.com";//email Address
        string password = "wiie scqg qxpr gqoz";// App Password
        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);
                // Authenticate with the server
                client.Authenticate(username, password);
                // Select the INBOX folder or any special folder
                client.Inbox.Open(FolderAccess.ReadOnly);
                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);
                foreach (var uid in uids)
                {
                    // Retrieve the message by UID
                    var message = client.Inbox.GetMessage(uid);
                    // Display message details
                    Console.WriteLine($"From: {message.From}");
                    Console.WriteLine($"Subject: {message.Subject}");
                    Console.WriteLine($"Date: {message.Date}");
                    Console.WriteLine($"Body: {message.TextBody}");
                    Console.WriteLine();
                }
                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

//Install-Package MailKit
using System;
using MailKit.Net.Imap;
using MailKit.Search;
using MimeKit;
class Program
{
    static void Main(string [] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;
        // IMAP credentials
        string username = "buttwaleed121@gmail.com";//email Address
        string password = "wiie scqg qxpr gqoz";// App Password
        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);
                // Authenticate with the server
                client.Authenticate(username, password);
                // Select the INBOX folder or any special folder
                client.Inbox.Open(FolderAccess.ReadOnly);
                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);
                foreach (var uid in uids)
                {
                    // Retrieve the message by UID
                    var message = client.Inbox.GetMessage(uid);
                    // Display message details
                    Console.WriteLine($"From: {message.From}");
                    Console.WriteLine($"Subject: {message.Subject}");
                    Console.WriteLine($"Date: {message.Date}");
                    Console.WriteLine($"Body: {message.TextBody}");
                    Console.WriteLine();
                }
                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

'Install-Package MailKit
Imports System
Imports MailKit.Net.Imap
Imports MailKit.Search
Imports MimeKit
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' IMAP server settings
		Dim imapServer As String = "imap.gmail.com"
		Dim imapPort As Integer = 993
		Dim useSsl As Boolean = True
		' IMAP credentials
		Dim username As String = "buttwaleed121@gmail.com" 'email Address
		Dim password As String = "wiie scqg qxpr gqoz" ' App Password
		Try
			Using client = New ImapClient()
				' Connect to the IMAP server
				client.Connect(imapServer, imapPort, useSsl)
				' Authenticate with the server
				client.Authenticate(username, password)
				' Select the INBOX folder or any special folder
				client.Inbox.Open(FolderAccess.ReadOnly)
				' Search for unread messages
				Dim searchQuery = SearchQuery.NotSeen
				Dim uids = client.Inbox.Search(searchQuery)
				For Each uid In uids
					' Retrieve the message by UID
					Dim message = client.Inbox.GetMessage(uid)
					' Display message details
					Console.WriteLine($"From: {message.From}")
					Console.WriteLine($"Subject: {message.Subject}")
					Console.WriteLine($"Date: {message.Date}")
					Console.WriteLine($"Body: {message.TextBody}")
					Console.WriteLine()
				Next uid
				' Disconnect from the server
				client.Disconnect(True)
			End Using
		Catch ex As Exception
			Console.WriteLine($"Error: {ex.Message}")
		End Try
	End Sub
End Class

VB C#

Dans cet exemple de code, nous utilisons MailKit pour nous connecter à un serveur IMAP, authentifier notre connexion avec le serveur à l'aide des informations d'identification fournies et récupérer les messages électroniques non lus dans le dossier INBOX. Nous parcourons ensuite la liste des UID des messages non lus, récupérons chaque message par UID et affichons ses détails, notamment l'expéditeur, l'objet, la date et le corps du message.

Sortie

C# Imap(Comment ça marche pour les développeurs) : Figure 6 - Sortie de la console

4. IronPDF

IronPDF est une puissante bibliothèque C# conçue pour simplifier la création, la manipulation et le rendu des documents PDF dans les applications .NET. Grâce à son API intuitive et à son vaste ensemble de fonctionnalités, IronPDF permet aux développeurs de générer, d'éditer et de manipuler des fichiers PDF de manière transparente et programmatique, améliorant ainsi la polyvalence et la fonctionnalité de leurs applications. Que vous ayez besoin de générer des rapports dynamiques, de convertir du contenu HTML en PDF, d'extraire du texte et des images à partir de PDF existants ou de signer numériquement des documents, IronPDF fournit une boîte à outils complète pour répondre à vos besoins en matière de traitement des PDF. En s'appuyant sur IronPDF, les développeurs peuvent rationaliser leurs tâches liées aux PDF et fournir facilement des solutions documentaires de haute qualité.

4.1. Installez IronPDF

IronPDF peut être installé à l'aide du gestionnaire de paquets NuGet en exécutant la commande suivante.

Install-Package IronPdf

4.2. Créer un PDF à partir d'e-mails provenant d'un serveur IMAP

using System;
using System.Collections.Generic;
using System.IO;
using MailKit.Net.Imap;
using MailKit.Search;
using MimeKit;
using IronPdf;
using MailKit;
class Program
{
    static void Main(string [] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;
        // IMAP credentials
        string username = "buttwaleed121@gmail.com";
        string password = "wiie scqg qxpr gqoz";
        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);
                // Authenticate with the server
                client.Authenticate(username, password);
                // Select the INBOX folder
                client.Inbox.Open(FolderAccess.ReadOnly);
                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);
                // Create a list to store message details
                var messages = new List<string>();
                // Retrieve details for the first 100 unread messages
                for (int i = 0; i < Math.Min(uids.Count, 100); i++)
                {
                    var uid = uids[i];
                    var message = client.Inbox.GetMessage(uid);
                    // Add message details to the list
                    messages.Add($"From: {message.From}");
                    messages.Add($"Subject: {message.Subject}");
                    messages.Add($"Date: {message.Date}");
                    messages.Add($"Body: {message.TextBody}");
                    messages.Add(""); // Add an empty line for separation
                }
                // Generate PDF report
                GeneratePdfReport(messages);
                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
    static void GeneratePdfReport(List<string> messages)
    {
        try
        {
            var pdf = new ChromePdfRenderer();
            // Convert message details to HTML format
            string htmlContent = "<h1>Not Seen Emails</h1><hr/>";
            foreach (var message in messages)
            {
                htmlContent += $"<p style='padding-top:30px;'>{message}</p>";
            }
            // Render HTML content to PDF
            var pdfOutput = pdf.RenderHtmlAsPdf(htmlContent);
            // Save PDF to file
            var outputPath = "Email_Report.pdf";
            pdfOutput.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated successfully: {outputPath}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF report: {ex.Message}");
        }
    }
}

using System;
using System.Collections.Generic;
using System.IO;
using MailKit.Net.Imap;
using MailKit.Search;
using MimeKit;
using IronPdf;
using MailKit;
class Program
{
    static void Main(string [] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;
        // IMAP credentials
        string username = "buttwaleed121@gmail.com";
        string password = "wiie scqg qxpr gqoz";
        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);
                // Authenticate with the server
                client.Authenticate(username, password);
                // Select the INBOX folder
                client.Inbox.Open(FolderAccess.ReadOnly);
                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);
                // Create a list to store message details
                var messages = new List<string>();
                // Retrieve details for the first 100 unread messages
                for (int i = 0; i < Math.Min(uids.Count, 100); i++)
                {
                    var uid = uids[i];
                    var message = client.Inbox.GetMessage(uid);
                    // Add message details to the list
                    messages.Add($"From: {message.From}");
                    messages.Add($"Subject: {message.Subject}");
                    messages.Add($"Date: {message.Date}");
                    messages.Add($"Body: {message.TextBody}");
                    messages.Add(""); // Add an empty line for separation
                }
                // Generate PDF report
                GeneratePdfReport(messages);
                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
    static void GeneratePdfReport(List<string> messages)
    {
        try
        {
            var pdf = new ChromePdfRenderer();
            // Convert message details to HTML format
            string htmlContent = "<h1>Not Seen Emails</h1><hr/>";
            foreach (var message in messages)
            {
                htmlContent += $"<p style='padding-top:30px;'>{message}</p>";
            }
            // Render HTML content to PDF
            var pdfOutput = pdf.RenderHtmlAsPdf(htmlContent);
            // Save PDF to file
            var outputPath = "Email_Report.pdf";
            pdfOutput.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated successfully: {outputPath}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF report: {ex.Message}");
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.IO
Imports MailKit.Net.Imap
Imports MailKit.Search
Imports MimeKit
Imports IronPdf
Imports MailKit
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' IMAP server settings
		Dim imapServer As String = "imap.gmail.com"
		Dim imapPort As Integer = 993
		Dim useSsl As Boolean = True
		' IMAP credentials
		Dim username As String = "buttwaleed121@gmail.com"
		Dim password As String = "wiie scqg qxpr gqoz"
		Try
			Using client = New ImapClient()
				' Connect to the IMAP server
				client.Connect(imapServer, imapPort, useSsl)
				' Authenticate with the server
				client.Authenticate(username, password)
				' Select the INBOX folder
				client.Inbox.Open(FolderAccess.ReadOnly)
				' Search for unread messages
				Dim searchQuery = SearchQuery.NotSeen
				Dim uids = client.Inbox.Search(searchQuery)
				' Create a list to store message details
				Dim messages = New List(Of String)()
				' Retrieve details for the first 100 unread messages
				For i As Integer = 0 To Math.Min(uids.Count, 100) - 1
					Dim uid = uids(i)
					Dim message = client.Inbox.GetMessage(uid)
					' Add message details to the list
					messages.Add($"From: {message.From}")
					messages.Add($"Subject: {message.Subject}")
					messages.Add($"Date: {message.Date}")
					messages.Add($"Body: {message.TextBody}")
					messages.Add("") ' Add an empty line for separation
				Next i
				' Generate PDF report
				GeneratePdfReport(messages)
				' Disconnect from the server
				client.Disconnect(True)
			End Using
		Catch ex As Exception
			Console.WriteLine($"Error: {ex.Message}")
		End Try
	End Sub
	Private Shared Sub GeneratePdfReport(ByVal messages As List(Of String))
		Try
			Dim pdf = New ChromePdfRenderer()
			' Convert message details to HTML format
			Dim htmlContent As String = "<h1>Not Seen Emails</h1><hr/>"
			For Each message In messages
				htmlContent &= $"<p style='padding-top:30px;'>{message}</p>"
			Next message
			' Render HTML content to PDF
			Dim pdfOutput = pdf.RenderHtmlAsPdf(htmlContent)
			' Save PDF to file
			Dim outputPath = "Email_Report.pdf"
			pdfOutput.SaveAs(outputPath)
			Console.WriteLine($"PDF report generated successfully: {outputPath}")
		Catch ex As Exception
			Console.WriteLine($"Error generating PDF report: {ex.Message}")
		End Try
	End Sub
End Class

VB C#

Nous créons une liste de messages pour stocker les détails des 100 premiers courriels non lus.
Dans la boucle de récupération des détails du courrier électronique, nous ajoutons les détails de chaque message à la liste messages.
Après avoir récupéré les détails de tous les courriels non lus ou des 100 premiers courriels, nous appelons la méthode GeneratePdfReport pour créer un rapport PDF contenant ces détails.
Dans la méthode GeneratePdfReport, nous convertissons les détails du message au format HTML et utilisons IronPDF pour rendre ce contenu HTML dans un fichier PDF.
Le rapport PDF est enregistré dans un fichier nommé "Email_Report.pdf".
Vous pouvez tester ce code en remplaçant les paramètres par défaut et les informations d'identification du serveur IMAP par les informations de votre propre serveur et en exécutant le programme. Il se connecte au serveur IMAP, récupère les détails des 100 premiers courriels non lus, génère un rapport PDF contenant ces détails et l'enregistre dans un fichier.

5. Conclusion

L'intégration de la fonctionnalité IMAP dans les applications C# ouvre un monde de possibilités pour la communication par courrier électronique, l'automatisation et l'amélioration de la productivité. En comprenant les principes fondamentaux de l'IMAP et en exploitant des bibliothèques puissantes comme MailKit .NET, les développeurs peuvent créer des clients de messagerie riches en fonctionnalités, automatiser les tâches de traitement du courrier électronique et rationaliser les flux de travail de communication en toute simplicité.

Grâce aux connaissances pratiques et aux exemples de code fournis dans ce guide, les développeurs sont équipés pour exploiter la puissance de l'intégration IMAP dans leurs applications C# et débloquer de nouvelles opportunités d'innovation et d'efficacité dans la communication par courrier électronique. Avec l'aide d'IronPDF, une bibliothèque polyvalente pour le traitement des PDF, vous pouvez enregistrer des pièces jointes en tant que PDF ou importer des courriels en tant que fichiers PDF ou stocker des courriels dans des documents PDF.

Pour en savoir plus sur IronPDF et ses fonctionnalités, visitez le site officiel de la sociétéPage de documentation IronPDF.

< PRÉCÉDENT
C# Groupby (Comment ça marche pour les développeurs)

SUIVANT >
C# Log (Comment ça marche pour les développeurs)