HMENetCore.Mail 6.0.47

HMENetCore.Mail

简介

HMENetCore.Mail 本封装库基于 MailKit 库，提供了对 IMAP/POP3 和 SMTP 协议的完整封装，实现了邮件的收取、发送、管理等功能。

功能特性

● IMAP 客户端：用于连接和操作 IMAP 邮件服务器，支持邮件收取、删除、移动、标记等操作。 ● SMTP 客户端：用于连接和操作 SMTP 邮件服务器，支持带附件、HTML格式邮件发送功能。 ● 邮件验证：提供对 IMAP、SMTP 和 POP3 服务器的连接和认证验证功能。 ● 依赖注入支持：支持通过 .NET Core 的依赖注入系统进行配置和注入。

.NET支持

• 跨平台支持: Supports .NET Standard 2.1, .NET 6, .NET 8, and .NET 9.

安装

dotnet add package HMENetCore.Mail --version 6.0.47

服务注册

//IMAP 客户端配置
services.AddSingleton<ImapMailClient>(serviceProvider =>
{
    var config = new MailConfigEntity
    {
        Host = "imap.example.com",
        Port = 993,
        IsSsl = true,
        Account = "your_account@example.com",
        Password = "your_password"
    };
    return new ImapMailClient(config);
});

//SMTP 客户端配置
services.AddSingleton<SendMailClient>(serviceProvider =>
{
    var config = new MailConfigEntity
    {
        Host = "smtp.example.com",
        Port = 587,
        IsSsl = true,
        Account = "your_account@example.com",
        Password = "your_password"
    };
    return new SendMailClient(config);
});

//邮件服务配置
services.AddSingleton<MailService>(serviceProvider =>
{
    var config = new MailConfigEntity
    {
        Host = "imap.example.com", // 或 smtp.example.com
        Port = 993, // 或 587
        IsSsl = true,
        Account = "your_account@example.com",
        Password = "your_password"
    };
    return new MailService(config);
});

使用示例

1. IMAP 客户端使用示例

public class ImapExample
{
    private readonly ImapMailClient _imapClient;

    public ImapExample(ImapMailClient imapClient)
    {
        _imapClient = imapClient;
    }

    // 连接 IMAP 服务器并获取邮件列表
    public async Task GetEmailListAsync()
    {
        try
        {
            // 连接到 IMAP 服务器
            await _imapClient.ConnectIMAPAsync();

            // 获取收件箱中的邮件列表
            var folder = _imapClient.GetMailFolderAsync("Inbox").Result;
            var messages = folder.Fetch(0, -1, MessageSummaryItems.UniqueId | MessageSummaryItems.Envelope).ToList();

            foreach (var message in messages)
            {
                Console.WriteLine($"Subject: {message.Envelope.Subject}");
                Console.WriteLine($"From: {message.Envelope.From.Mailboxes.FirstOrDefault()?.Address}");
                Console.WriteLine($"Date: {message.Envelope.Date.Value.DateTime}");
                Console.WriteLine("----------------------------------");
            }

            // 断开连接
            _imapClient.DisconnectIMAP();
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    //删除指定邮件
    public async Task DeleteEmailAsync(uint uniqueId)
    {
        try
        {
            // 连接到 IMAP 服务器
            await _imapClient.ConnectIMAPAsync();

            // 获取收件箱
            var folder = _imapClient.GetMailFolderAsync("Inbox").Result;
            folder.Open(FolderAccess.ReadWrite);

            // 删除指定邮件
            var uniqueIds = new List<uint> { uniqueId };
            _imapClient.DeleteEmailAsync(uniqueIds, "Inbox").Wait();

            // 断开连接
            _imapClient.DisconnectIMAP();
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    //批量删除邮件
    public async Task BatchDeleteEmailsAsync(List<uint> uniqueIds)
    {
        try
        {
            await _imapClient.ConnectIMAPAsync();
            var folder = _imapClient.GetMailFolderAsync("Inbox").Result;
            folder.Open(FolderAccess.ReadWrite);

            _imapClient.DeleteEmailAsync(uniqueIds, "Inbox").Wait();

            folder.Close();
            _imapClient.DisconnectIMAP();
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    //标记邮件为已读
    public async Task MarkEmailAsReadAsync(uint uniqueId)
    {
        try
        {
            await _imapClient.ConnectIMAPAsync();
            var folder = _imapClient.GetMailFolderAsync("Inbox").Result;
            folder.Open(FolderAccess.ReadWrite);

            var uniqueIds = new List<uint> { uniqueId };
            _imapClient.SetFlagAsync(uniqueIds, 1, "Inbox").Wait(); // 1 = 已读

            folder.Close();
            _imapClient.DisconnectIMAP();
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

}

2. SMTP 客户端使用示例

public class SmtpExample
{
    private readonly SendMailClient _smtpClient;

    public SmtpExample(SendMailClient smtpClient)
    {
        _smtpClient = smtpClient;
    }

    //发送邮件
    public async Task SendEmailAsync()
    {
        try
        {
            // 准备邮件内容
            var mailBody = new MailBodyEntity
            {
                Senders = new List<MailAddress> { new MailAddress { DisplayName = "Sender", Address = "sender@example.com" } },
                Recipients = new List<MailAddress> { new MailAddress { DisplayName = "Recipient", Address = "recipient@example.com" } },
                Subject = "Test Email",
                BodyHTML = "<h1>Hello, World!</h1>",
                IsReceipt = false
            };

            // 发送邮件
            var result = await _smtpClient.SendMailAsync(mailBody);

            if (result.status)
            {
                Console.WriteLine("Email sent successfully.");
            }
            else
            {
                Console.WriteLine($"Failed to send email: {result.message}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

3. 邮件验证使用示例

public class MailVerifyExample
{
    private readonly MailVerifyUtil _mailVerifyUtil;

    public MailVerifyExample(MailVerifyUtil mailVerifyUtil)
    {
        _mailVerifyUtil = mailVerifyUtil;
    }

    //验证 IMAP 服务器连接
    public async Task VerifyImapServerAsync()
    {
        try
        {
            var config = new MailConfigEntity
            {
                Host = "imap.example.com",
                Port = 993,
                IsSsl = true,
                Account = "your_account@example.com",
                Password = "your_password"
            };

            var result = await _mailVerifyUtil.ImapVerifyAsync(config);

            if (result.status)
            {
                Console.WriteLine("IMAP server verification successful.");
            }
            else
            {
                Console.WriteLine($"IMAP server verification failed: {result.message}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}