1 需求概述
指定一批邮箱地址，使用指定的邮箱发送指定的内容。
2 功能需求
- 配置文件配置用于发送的邮箱信息
- 邮件发送功能
- 日志窗口输出显示
3 界面接口
- 邮件列表框
- 标题内容输入框
- 发送按钮
- 日志输出框
4 技术选型
.Net 4.0 C# Winform
5 实现
5.1 新建项目
- 项目命名为 SimpleEmailSender
image.png
5.2 在项目中添加配置文件
- 配置发件邮箱信息
<configuration> <appSettings> <add key="email_stmp" value="smtp.****.com"/> <add key="send_user_email" value="****@****"/> <add key="send_user_pass" value="密码"/> <add key="send_user_disp" value="发件人昵称" /> </appSettings> </configuration>
5.3 制作界面
根据界面接口需求，界面布局如下：
5.4 邮件发送辅助类
首先完成辅助类开发，最后再跟界面对接完成流程。
因为读取了配置文件，需要添加 System.Configuration 程序集的引用。
定义 MailHelper 辅助类，读取配置参数，向外提供发送邮件功能方法 SendMail。
using System;
using System.Collections.Generic;
using System.Configuration;
using System.Linq;
using System.Net.Mail;
using System.Text;
namespace SimpleEmailSender
{
public class MailHelper
{
public static String EMAIL_USERNAME = ConfigurationManager.AppSettings["send_user_email"];
public static String EMAIL_DISPNAME = ConfigurationManager.AppSettings["send_user_disp"];
public static String EMAIL_PASSWORD = ConfigurationManager.AppSettings["send_user_pass"];
public static String EMAIL_SMTP = ConfigurationManager.AppSettings["email_stmp"];
public static ValidateResult SendMail(string email, string name, string content)
{
return SendMail("系统消息", email, name, content);
}
/// <summary>
/// 发送邮件
/// </summary>
/// <param name="title">邮件标题</param>
/// <param name="email">收件人地址</param>
/// <param name="name">收件人名称</param>
/// <param name="content">邮件内容</param>
public static ValidateResult SendMail(string title, string email, string name, string content)
{
MailAddress from = new MailAddress(EMAIL_USERNAME, EMAIL_DISPNAME); //邮件的发件人"jinshuikeji@163.com", "system"
MailMessage mail = new MailMessage();
//设置邮件的标题
mail.Subject = title;
//设置邮件的发件人
//Pass:如果不想显示自己的邮箱地址，这里可以填符合mail格式的任意名称，真正发mail的用户不在这里设定，这个仅仅只做显示用
mail.From = from;
//设置邮件的收件人
mail.To.Add(new MailAddress(email, name));
//设置邮件的内容
mail.Body = content;
//设置邮件的格式
mail.BodyEncoding = System.Text.Encoding.UTF8;
mail.IsBodyHtml = true;
//设置邮件的发送级别
mail.Priority = MailPriority.Normal;
mail.DeliveryNotificationOptions = DeliveryNotificationOptions.OnSuccess;
SmtpClient client = new SmtpClient();
//设置用于 SMTP 事务的主机的名称，填IP地址也可以了
client.Host = EMAIL_SMTP;
//设置用于 SMTP 事务的端口，默认的是 25
client.Port = 25;
client.UseDefaultCredentials = false;
//这里才是真正的邮箱登陆名和密码
client.Credentials = new System.Net.NetworkCredential(EMAIL_USERNAME, EMAIL_PASSWORD);
client.DeliveryMethod = SmtpDeliveryMethod.Network;
//都定义完了，正式发送了，很是简单吧！
ValidateResult vr = new ValidateResult(true, "发送成功！");
try
{
client.Send(mail);
return vr;
}
catch (Exception e)
{
vr.IsValid = false;
vr.Message = e.Message;
return vr;
}
}
}
public class ValidateResult
{
public bool IsValid { get; set; }
public string Message { get; set; }
public ValidateResult() {
}
public ValidateResult(bool v, string m)
{
IsValid = v;
Message = m;
}
}
}
5.5 清单解析
对于邮箱列表，使用正则表达式从文本框中匹配邮箱形成 List<string> emailList 给后续执行。这样，对邮箱列表文本框中输入的格式就没什么要求，从其它地方复制粘贴进来，由程序完成格式化显示即可。
/// <summary>
/// 提取邮件列表
/// </summary>
/// <param name="mails"></param>
/// <returns></returns>
private List<string> ParseEmailList(string mails)
{
List<string> list = new List<string>();
var mc = Regex.Matches(mails, @"\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+", RegexOptions.IgnoreCase);
foreach (Match c in mc)
{
list.Add(c.Value);
}
return list;
}
5.6 日志输出方法准备
在日志框中输出内容，为了能在线程中调用，使用了 Invoke 方式执行。
/// <summary>
/// 日志输出支持线程中执行
/// </summary>
/// <param name="message"></param>
private void Log(string message)
{
Invoke(new MethodInvoker(delegate
{
txtLog.AppendText(message + "\r\n");
}));
}
5.7 线程发送
- 发送方案设计
基本描述：给定邮箱列表，标题与内容，以线程方式执行发送，给出执行统计与状态。
具体实现：使用线程池，但一组做为一个任务，全部完成才接收下一个任务，通过完成数量与邮箱列表长度的比较来判断是否全部完成，信息通过日志输出的方式查看，形式上通过回调将日志信息传递给调用者。
为此，这里专门定义一个发送器，在应用中，定义一个实例来发起任务。尽管只定义一个实例，但这里并不需要定义为设计模式中的单例模式，事实上，它是可以多实例运行。具体代码说话！
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
namespace SimpleEmailSender
{
public class EmailSender
{
#region 运行时数据
// 邮箱列表
private List<string> _EmailList = new List<string>();
// 完成数量
private volatile int _OverCount = 0;
// 邮件标题
private string _Title;
// 邮件内容
private string _Content;
// 完成回调（主要是为了写日志）
private Action<string> _Callback;
#endregion
/// <summary>
/// 是否全部完成
/// </summary>
/// <returns></returns>
public bool IsOver()
{
return _OverCount == _EmailList.Count;
}
/// <summary>
/// 发起任务（如果不符合发起条件，则返回 false）
/// </summary>
/// <param name="emails"></param>
/// <param name="title"></param>
/// <param name="content"></param>
/// <param name="callback"></param>
/// <returns></returns>
public bool Send(List<string> emails, string title, string content, Action<string> callback)
{
if (!IsOver())
{
return false;
}
_EmailList = emails;
_OverCount = 0;
_Title = title;
_Content = content;
_Callback = callback;
Start();
return true;
}
/// <summary>
/// 启动任务
///
/// 以线程池方式运行，每个邮箱不论成败完成数加1，并回调通知。
/// </summary>
private void Start()
{
foreach (string email in _EmailList)
{
var _email = email;
ThreadPool.QueueUserWorkItem(t =>
{
var vr = MailHelper.SendMail(_Title, _email, "", _Content);
_OverCount++;
_Callback(String.Format("进度[{3}/{4}] {0} 发送 {1}，返回：{2}", _email, vr.IsValid ? "成功" : "失败", vr.Message, _OverCount, _EmailList.Count));
});
}
}
}
}
5.8 按钮事件
发送按钮执行的流程为：如果之前的任务尚未完成，则等待。否则，首先提取邮箱列表，并格式化显示，然后发起任务，观察日志即可。
private EmailSender _Sender = new EmailSender();
// 发送按钮
private void btnSend_Click(object sender, EventArgs e)
{
if (!_Sender.IsOver())
{
Log("之前的任务尚未完成，请等待完成！");
return;
}
// 1. 提取邮件列表并格式化显示
string mails = txtEmailList.Text.Trim();
var list = ParseEmailList(mails);
// 2. 格式化显示一下
txtEmailList.Clear();
foreach (var mail in list)
{
txtEmailList.AppendText(mail + "\r\n");
}
// 3. 发起任务
var b = _Sender.Send(list, txtTitle.Text.Trim(), txtContent.Text, Log);
Log(b ? "发起成功" : "发起失败");
}
6 运行结果
6.1 配置信息错误时
6.2 配置信息正确时
image.png
7 项目源代码
https://github.com/triplestudio/SimpleEmailSender