基于Lumisoft.NET组件和.NET API实现邮件发送功能的对比
我在较早时期的一篇文章《
基于Lumisoft.NET实现的邮件发送功能
》有大致对这个Lumisoft.NET组件的使用进行了介绍，在《
DevExpress控件使用之RichEditControl的使用
》则对使用.NET API进行邮件发送进行了说明，其实，实现邮件发送，这两种方式是比较常见的，当然Lumisoft.NET组件除了提供邮件发送功能外，还提供了邮件接收等功能的处理（包括基于POP3协议和IMAP协议），而.NET则除了提供SMTP协议功能外，则没有提供POP3协议处理的相关类库，因此收取邮件这需要自己进行封装（需要也可以参考codeproject.com上的相关文章）。
1、.NET的邮件发送功能实现
.NET本身封装了一个SmtpClient类以及相关的邮件对象类，这样利用这些类库，也可以方便实现邮件的发送功能的了。
如添加发送人地址，抄送地址，以及暗送地址（多个地址用逗号分开）代码如下。
string toEmails =mailInfo.ToEmail;string bcc = "";
mailInfo.RecipientBCC.ForEach(obj=> bcc += string.Format("{0},", obj));
bcc= bcc.Trim(',');string cc = "";
mailInfo.RecipientCC.ForEach(obj=> cc += string.Format("{0},", obj));
cc= cc.Trim(',');
MailMessage mail= newMailMessage(settingInfo.MailFrom, toEmails);if (!string.IsNullOrEmpty(bcc))
{
mail.Bcc.Add(bcc);
}if (!string.IsNullOrEmpty(cc))
{
mail.CC.Add(cc);
}
.NET的附件和嵌入式资源由对象Attachment和LinkedResource进行管理，他们的利用代码如下所示：
//附件 foreach (string fileName inmailInfo.Attachments)
{
mail.Attachments.Add(newAttachment(fileName));
}//嵌入资源 AlternateView view =AlternateView.CreateAlternateViewFromString(mailInfo.Body, Encoding.UTF8, MediaTypeNames.Text.Html);foreach (LinkedAttachementInfo link inmailInfo.EmbedObjects)
{
LinkedResource resource= newLinkedResource(link.Stream, link.MimeType);
resource.ContentId=link.ContentId;
view.LinkedResources.Add(resource);
}
mail.AlternateViews.Add(view);
发送邮件的其他部分代码如下所示
mail.IsBodyHtml =mailInfo.IsBodyHtml;
mail.BodyEncoding=Encoding.UTF8;
mail.Subject=mailInfo.Subject;
mail.SubjectEncoding=Encoding.UTF8;//发送账户设置信息 SmtpClient client = newSmtpClient();
client.Host=settingInfo.SmtpServer;
client.Port=settingInfo.SmptPort;
client.UseDefaultCredentials= false;
client.DeliveryMethod=SmtpDeliveryMethod.Network;
client.Credentials= newNetworkCredential(settingInfo.SmtpUser, settingInfo.SmtpPass);bool success = false;try{
client.Send(mail);
success= true;
}catch(Exception ex)
{
LogTextHelper.Error(ex);//throw; }
上面利用.net的SmtpClient发送邮件操作的完整代码如下:
/// <summary> ///发送外部邮件（系统配置，系统邮件）/// </summary> /// <param name="mailInfo">发送邮件信息</param> /// <returns></returns> publicCommonResult Send(MailInfo mailInfo)
{
CommonResult result= newCommonResult();try{
AppConfig config= newAppConfig();string MailDomain = config.AppConfigGet("MailDomain");string MailUsername = config.AppConfigGet("MailUsername");string MailPassword = config.AppConfigGet("MailPassword");string MailPort = config.AppConfigGet("MailPort");string MailFrom = config.AppConfigGet("MailFrom");int port = 25;int.TryParse(MailPort, outport);
SmtpSettingInfo settingInfo= newSmtpSettingInfo(MailDomain, port,
MailUsername, MailPassword, MailFrom);
result.Success=PrivateSendEmail(mailInfo, settingInfo);
}catch(Exception ex)
{
result.ErrorMessage=ex.Message;throw;
}returnresult;
}/// <summary> ///通用发送邮件操作/// </summary> private static boolPrivateSendEmail(MailInfo mailInfo, SmtpSettingInfo settingInfo)
{string toEmails =mailInfo.ToEmail;string bcc = "";
mailInfo.RecipientBCC.ForEach(obj=> bcc += string.Format("{0},", obj));
bcc= bcc.Trim(',');string cc = "";
mailInfo.RecipientCC.ForEach(obj=> cc += string.Format("{0},", obj));
cc= cc.Trim(',');
MailMessage mail= newMailMessage(settingInfo.MailFrom, toEmails);if (!string.IsNullOrEmpty(bcc))
{
mail.Bcc.Add(bcc);
}if (!string.IsNullOrEmpty(cc))
{
mail.CC.Add(cc);
}//附件 foreach (string fileName inmailInfo.Attachments)
{
mail.Attachments.Add(newAttachment(fileName));
}//嵌入资源 AlternateView view =AlternateView.CreateAlternateViewFromString(mailInfo.Body, Encoding.UTF8, MediaTypeNames.Text.Html);foreach (LinkedAttachementInfo link inmailInfo.EmbedObjects)
{
LinkedResource resource= newLinkedResource(link.Stream, link.MimeType);
resource.ContentId=link.ContentId;
view.LinkedResources.Add(resource);
}
mail.AlternateViews.Add(view);
mail.IsBodyHtml=mailInfo.IsBodyHtml;
mail.BodyEncoding=Encoding.UTF8;
mail.Subject=mailInfo.Subject;
mail.SubjectEncoding=Encoding.UTF8;//发送账户设置信息 SmtpClient client = newSmtpClient();
client.Host=settingInfo.SmtpServer;
client.Port=settingInfo.SmptPort;
client.UseDefaultCredentials= false;
client.DeliveryMethod=SmtpDeliveryMethod.Network;
client.Credentials= newNetworkCredential(settingInfo.SmtpUser, settingInfo.SmtpPass);bool success = false;try{
client.Send(mail);
success= true;
}catch(Exception ex)
{
LogTextHelper.Error(ex);//throw; }string message = string.Format("发送给【{0}】的邮件“{1}”，{2}，时间：{3}",
mailInfo.ToEmail[0], mailInfo.Subject, success ? "发送成功" : "发送失败", DateTime.Now);
LogTextHelper.Info(message);returnsuccess;
}
2、基于Lumisoft.NET组件的邮件发送功能实现
基于Lumisoft.NET组件的邮件发送，也是一种很常用的，因为这个开源组件非常强大，经常可以在一些程序中被使用。
这个发送邮件的功能主要是利用SMTP_Client类来实现的，如下代码所示。注意其中的Authenticate函数已经被舍弃，可以使用Auth方法进行验证。但是函数参数有所不同，根据验证对象，使用不同的验证方式，一般选择AUTH_SASL_Client_Plain对象即可。
public boolSend()
{bool sended = false;using (SMTP_Client client = newSMTP_Client())
{
client.Connect(smtpServer, smtpPort, smtpUseSsl);
client.EhloHelo(smtpServer);var authhh = newAUTH_SASL_Client_Plain(username, password);
client.Auth(authhh);//client.Authenticate(username, password);//string text = client.GreetingText; client.MailFrom(from, -1);foreach (string address intoList.Keys)
{
client.RcptTo(address);
}//采用Mail_Message类型的Stream Mail_Message m = Create_PlainText_Html_Attachment_Image(toList, ccList, from, fromDisplay, subject, body, attachments);using (MemoryStream stream = newMemoryStream())
{
m.ToStream(stream,newMIME_Encoding_EncodedWord(MIME_EncodedWordEncoding.Q, Encoding.UTF8), Encoding.UTF8);
stream.Position= 0;
client.SendMessage(stream);
sended= true;
}if (m != null)
{
m.Dispose();
}
client.Disconnect();
}returnsended;
}
构造用于SMTP发送的数据，可以使用Mail_Message 对象，也可以使用Mime对象，虽然读都可以实现发送功能，不过Mime对象是舍弃的对象了。
构造Mail_Message对象后，创建用于发送的格式要转换为Stream对象。转换为发送的Stream操作如下所示。
using (MemoryStream stream = newMemoryStream())
{
m.ToStream(stream,newMIME_Encoding_EncodedWord(MIME_EncodedWordEncoding.Q, Encoding.UTF8), Encoding.UTF8);
stream.Position= 0;
client.SendMessage(stream);
sended= true;
}
构造Mail_Message格式的邮件操作如下所示。
private Mail_Message Create_PlainText_Html_Attachment_Image(Dictionary<string,string> tomails, Dictionary<string, string> ccmails, string mailFrom, stringmailFromDisplay,string subject, string body, Dictionary<string, string> attachments, string notifyEmail = "", string plaintTextTips = "")
{
Mail_Message msg= newMail_Message();
msg.MimeVersion= "1.0";
msg.MessageID=MIME_Utils.CreateMessageID();
msg.Date=DateTime.Now;
msg.Subject=subject;
msg.From= newMail_t_MailboxList();
msg.From.Add(newMail_t_Mailbox(mailFromDisplay, mailFrom));
msg.To= newMail_t_AddressList();foreach (string address intomails.Keys)
{string displayName =tomails[address];
msg.To.Add(newMail_t_Mailbox(displayName, address));
}
msg.Cc= newMail_t_AddressList();foreach (string address inccmails.Keys)
{string displayName =ccmails[address];
msg.Cc.Add(newMail_t_Mailbox(displayName, address));
}//设置回执通知 if (!string.IsNullOrEmpty(notifyEmail) &&ValidateUtil.IsEmail(notifyEmail))
{
msg.DispositionNotificationTo.Add(newMail_t_Mailbox(notifyEmail, notifyEmail));
}#region MyRegion //--- multipart/mixed ----------------------------------- MIME_h_ContentType contentType_multipartMixed = newMIME_h_ContentType(MIME_MediaTypes.Multipart.mixed);
contentType_multipartMixed.Param_Boundary= Guid.NewGuid().ToString().Replace('-', '.');
MIME_b_MultipartMixed multipartMixed= newMIME_b_MultipartMixed(contentType_multipartMixed);
msg.Body=multipartMixed;//--- multipart/alternative ----------------------------- MIME_Entity entity_multipartAlternative = newMIME_Entity();
MIME_h_ContentType contentType_multipartAlternative= newMIME_h_ContentType(MIME_MediaTypes.Multipart.alternative);
contentType_multipartAlternative.Param_Boundary= Guid.NewGuid().ToString().Replace('-', '.');
MIME_b_MultipartAlternative multipartAlternative= newMIME_b_MultipartAlternative(contentType_multipartAlternative);
entity_multipartAlternative.Body=multipartAlternative;
multipartMixed.BodyParts.Add(entity_multipartAlternative);//--- text/plain ---------------------------------------- MIME_Entity entity_text_plain = newMIME_Entity();
MIME_b_Text text_plain= newMIME_b_Text(MIME_MediaTypes.Text.plain);
entity_text_plain.Body=text_plain;//普通文本邮件内容，如果对方的收件客户端不支持HTML，这是必需的 string plainTextBody = "如果你邮件客户端不支持HTML格式，或者你切换到“普通文本”视图，将看到此内容";if (!string.IsNullOrEmpty(plaintTextTips))
{
plainTextBody=plaintTextTips;
}
text_plain.SetText(MIME_TransferEncodings.QuotedPrintable, Encoding.UTF8, plainTextBody);
multipartAlternative.BodyParts.Add(entity_text_plain);//--- text/html ----------------------------------------- string htmlText = body;//"<html>这是一份测试邮件，<img src=\"cid:test.jpg\">来自<font color=red><b>LumiSoft.Net</b></font></html>"; MIME_Entity entity_text_html = newMIME_Entity();
MIME_b_Text text_html= newMIME_b_Text(MIME_MediaTypes.Text.html);
entity_text_html.Body=text_html;
text_html.SetText(MIME_TransferEncodings.QuotedPrintable, Encoding.UTF8, htmlText);
multipartAlternative.BodyParts.Add(entity_text_html);//--- application/octet-stream ------------------------- WebClient client = newWebClient();foreach (string attach inattachments.Keys)
{try{byte[] bytes =client.DownloadData(attach);using (MemoryStream stream = newMemoryStream(bytes))
{
multipartMixed.BodyParts.Add(Mail_Message.CreateAttachment(stream, attachments[attach]));
}
}catch(Exception ex)
{
LogTextHelper.Error(ex);
}
}#endregion returnmsg;
}
而构造Mime格式的操作如下所示。
private Mime Create_Html_Attachment_Image(string mailTo, string mailFrom, stringmailFromDisplay,string subject, string body, List<string> attachments, Dictionary<string, string> embedImages, string notifyEmail = "", string plaintTextTips = "",string replyEmail = "")
{
Mime m= newMime();
MimeEntity mainEntity=m.MainEntity;
mainEntity.From= newAddressList();
mainEntity.From.Add(newMailboxAddress(mailFromDisplay, mailFrom));
mainEntity.To= newAddressList();
mainEntity.To.Add(newMailboxAddress(mailTo, mailTo));
mainEntity.Subject=subject;
mainEntity.ContentType=MediaType_enum.Multipart_mixed;//设置回执通知 if (!string.IsNullOrEmpty(notifyEmail) &&ValidateUtil.IsEmail(notifyEmail))
{
mainEntity.DSN=notifyEmail;
}//设置统一回复地址 if (!string.IsNullOrEmpty(replyEmail) &&ValidateUtil.IsEmail(replyEmail))
{
mainEntity.ReplyTo= newAddressList();
mainEntity.ReplyTo.Add(newMailboxAddress(replyEmail, replyEmail));
}
MimeEntity textEntity=mainEntity.ChildEntities.Add();
textEntity.ContentType=MediaType_enum.Text_html;
textEntity.ContentTransferEncoding=ContentTransferEncoding_enum.QuotedPrintable;
textEntity.DataText=body;//附件 foreach (string attach inattachments)
{
MimeEntity attachmentEntity=mainEntity.ChildEntities.Add();
attachmentEntity.ContentType=MediaType_enum.Application_octet_stream;
attachmentEntity.ContentDisposition=ContentDisposition_enum.Attachment;
attachmentEntity.ContentTransferEncoding=ContentTransferEncoding_enum.Base64;
FileInfo file= newFileInfo(attach);
attachmentEntity.ContentDisposition_FileName=file.Name;
attachmentEntity.DataFromFile(attach);
}//嵌入图片 foreach (string key inembedImages.Keys)
{
MimeEntity attachmentEntity=mainEntity.ChildEntities.Add();
attachmentEntity.ContentType=MediaType_enum.Application_octet_stream;
attachmentEntity.ContentDisposition=ContentDisposition_enum.Inline;
attachmentEntity.ContentTransferEncoding=ContentTransferEncoding_enum.Base64;string imageFile =embedImages[key];
FileInfo file= newFileInfo(imageFile);
attachmentEntity.ContentDisposition_FileName=file.Name;//string displayName = Path.GetFileNameWithoutExtension(fileName); attachmentEntity.ContentID = key;//BytesTools.BytesToHex(Encoding.Default.GetBytes(fileName)); attachmentEntity.DataFromFile(imageFile);
}returnm;
}
综合以上两者的发送功能，都可以实现邮件的发送操作，如下界面是发送邮件界面。
3、LumiSoft.NET存储eml邮件文件以及发送eml文件操作
除了上面的发送普通邮件，Lumisoft还支持吧邮件序列号存储到文件(.eml邮件文件)里面，然后也可以通过把文件读取到流里面，进行发送，对于某种场合，可以把邮件存储到eml文件是一个很好的操作。
存储EML文件的相关操作如下所示。
private void btnCreateFile_Click(objectsender, EventArgs e)
{string attachFile = Path.Combine(Application.StartupPath, "Attachment/Hotel2.png");
List<string> attachments = new List<string>();
attachments.Add(attachFile);string subject = "测试邮件";string body = "<html>这是一份测试邮件，来自<font color=red><b>LumiSoft.Net</b></font></html>";string bodyEmbedy = "<html>这是一份测试邮件<img src=\"cid:test.jpg\">，来自<font color=red><b>LumiSoft.Net</b></font></html>";
Dictionary<string, string> embedList = new Dictionary<string, string>();
embedList.Add("test.jpg", "C:\\test.jpg");//存储为Eml文件 string path = Path.Combine(Application.StartupPath, "Eml");
DirectoryUtil.AssertDirExist(path);string emlFile = string.Format("{0}/{1}.eml", path, DateTime.Now.ToFileTime());
Mime m= Create_Html_Attachment_Image(to, from, from, subject, bodyEmbedy, attachments, embedList);
m.ToFile(emlFile);
MessageUtil.ShowTips("OK");
}
发送EML文件操作如下所示。
private void btnSendFile_Click(objectsender, EventArgs e)
{using (SMTP_Client client = newSMTP_Client())
{int smtpPort = smtpUseSsl ?WellKnownPorts.SMTP_SSL : WellKnownPorts.SMTP;
client.Connect(smtpServer, smtpPort, smtpUseSsl);
client.EhloHelo(smtpServer);//var authhh = new AUTH_SASL_Client_Plain(username, password);//client.Auth(authhh); client.Authenticate(username, password);//string text = client.GreetingText; client.MailFrom(from, -1);
client.RcptTo(to);string path = Path.Combine(Application.StartupPath, "Eml");string emlFile = Directory.GetFiles(path)[0];var msg =Mail_Message.ParseFromFile(emlFile);
MemoryStream stream= newMemoryStream();
msg.ToStream(stream,newMIME_Encoding_EncodedWord(MIME_EncodedWordEncoding.Q, Encoding.UTF8), Encoding.UTF8);
stream.Position= 0;
client.SendMessage(stream);
client.Disconnect();
}
MessageUtil.ShowTips("OK");
}