asp.net发送E-mail

发送电子邮件也是项目开发当中经常用到的功能，这里我整理了一个发送电子邮件（带附件，支持多用户发送，主送、抄送）的类库，供大家参考。

先上两个实体类，用于封装成Mail对象。

    /// <summary>
    /// 发送邮件请求
    /// </summary>
    public class MailRequest
    {
        #region PrivateFields

        /// <summary>
        /// 文件名
        /// </summary>
        private string _fromField;

        /// <summary>
        /// 返送到
        /// </summary>
        private string _toField;

        /// <summary>
        /// 抄送
        /// </summary>
        private string _copyField;

        /// <summary>
        /// 附件
        /// </summary>
        private string _bccField;

        /// <summary>
        /// 标题
        /// </summary>
        private string _subjectField;

        /// <summary>
        /// 发送人名
        /// </summary>
        private string _bodyField;

        /// <summary>
        /// 类容
        /// </summary>
        private MailRequestAttachments[] _attachmentsField;

        #endregion

        /// <summary>
        /// 发送人，多个人以分号;间隔
        /// </summary>
        public string From
        {
            get
            {
                return this._fromField;
            }

            set
            {
                this._fromField = value;
            }
        }

        /// <summary>
        /// 收件人，多个人以分号;间隔
        /// </summary>
        public string To
        {
            get
            {
                return this._toField;
            }

            set
            {
                this._toField = value;
            }
        }

        /// <summary>
        /// 抄送人，多个人以分号;间隔
        /// </summary>
        public string CC
        {
            get
            {
                return this._copyField;
            }

            set
            {
                this._copyField = value;
            }
        }

        /// <summary>
        /// 秘密抄送人，多个人以分号;间隔
        /// </summary>
        public string Bcc
        {
            get
            {
                return this._bccField;
            }

            set
            {
                this._bccField = value;
            }
        }

        /// <summary>
        /// 主题
        /// </summary>
        public string Subject
        {
            get
            {
                return this._subjectField;
            }

            set
            {
                this._subjectField = value;
            }
        }

        /// <summary>
        /// 内容
        /// </summary>
        public string Body
        {
            get
            {
                return this._bodyField;
            }

            set
            {
                this._bodyField = value;
            }
        }

        /// <summary>
        /// 附件列表
        /// </summary>
        public MailRequestAttachments[] Attachments
        {
            get
            {
                return this._attachmentsField;
            }

            set
            {
                this._attachmentsField = value;
            }
        }
    }

    /// <summary>
    /// 发送邮件请求附件
    /// </summary>
    public class MailRequestAttachments
    {
        #region PrivateFields

        /// <summary>
        /// 文件名
        /// </summary>
        private string _fileNameField;

        /// <summary>
        /// 文件内容
        /// </summary>
        private byte[] _fileDataField;

        #endregion

        /// <summary>
        /// 文件名
        /// </summary>
        public string FileName
        {
            get
            {
                return this._fileNameField;
            }

            set
            {
                this._fileNameField = value;
            }
        }

        /// <summary>
        /// 文件内容
        /// </summary>
        public byte[] FileData
        {
            get
            {
                return this._fileDataField;
            }

            set
            {
                this._fileDataField = value;
            }
        }
    }

附件的内容很简单，因为在网络传输当中，是以字节流的形式传输的，因此附件的传输需要转换成字节流数组。

    /// <summary>
    /// 邮件帮助类
    /// </summary>
    public static class MailHelper
    {
        /// <summary>
        /// 发送邮件
        /// </summary>
        /// <param name="request">邮件内容对象</param>
        /// <returns>发送邮件所遇到的异常</returns>
        public static string SendMail(MailRequest request)
        {
            try
            {
                MailMessage mail = new MailMessage();

                if (string.IsNullOrEmpty(request.From))
                {
                    request.From = WebConfigurationManager.AppSettings["DefaultMailFrom"];
                }
                mail.From = new MailAddress(request.From);

                PaserMailAddress(request.To, mail.To);
                PaserMailAddress(request.CC, mail.CC);
                PaserMailAddress(request.Bcc, mail.Bcc);

                mail.Subject = request.Subject;
                mail.SubjectEncoding = System.Text.Encoding.UTF8;
                mail.Body = request.Body;
                mail.ReplyTo = new MailAddress(request.From);
                mail.IsBodyHtml = true;

                if (request.Attachments != null && request.Attachments.Length > 0)
                {
                    for (int i = 0; i < request.Attachments.Length; i++)
                    {
                        Attachment mailAttach = new Attachment(ByteArrayToStream(request.Attachments[i].FileData), request.Attachments[i].FileName);

                        mail.Attachments.Add(mailAttach);
                    }
                }

                if (string.IsNullOrEmpty(WebConfigurationManager.AppSettings["SMTPSERVER"]))
                {
                    throw new ApplicationException("邮件服务无效");
                }

                //Smtp Server
                SmtpClient mailClient = new SmtpClient(WebConfigurationManager.AppSettings["SMTPSERVER"]);

                if (!string.IsNullOrEmpty(WebConfigurationManager.AppSettings["SMTPSERVERPORT"]))
                {
                    //端口号
                    try
                    {
                        mailClient.Port = Int32.Parse(WebConfigurationManager.AppSettings["SMTPSERVERPORT"]);
                    }
                    catch
                    {
                        return "SMTP服务器端口设置错误，端口必须设置为数值型";
                    }
                }

                if (!string.IsNullOrEmpty(WebConfigurationManager.AppSettings["MAILUSER"]))
                {
                    mailClient.Credentials = new System.Net.NetworkCredential(WebConfigurationManager.AppSettings["MAILUSER"], WebConfigurationManager.AppSettings["MAILUSERPW"]);
                    mailClient.DeliveryMethod = SmtpDeliveryMethod.Network;
                }
                else
                {
                    mailClient.Credentials = CredentialCache.DefaultNetworkCredentials;
                }

                mailClient.Send(mail);
                mail.Dispose();

                return "邮件发送成功。";
            }
            catch (SmtpFailedRecipientsException e)
            {
                return e.Message;
            }
            catch (SmtpFailedRecipientException e)
            {
                return e.Message;
            }
            catch (SmtpException e)
            {
                return e.Message;
            }
            catch (Exception e)
            {
                return e.Message;
            }
        }

        /// <summary>
        /// 解析分解邮件地址
        /// </summary>
        /// <param name="mailAddress">邮件地址</param>
        /// <param name="mailCollection">邮件对象</param>
        private static void PaserMailAddress(string mailAddress, MailAddressCollection mailCollection)
        {
            if (string.IsNullOrEmpty(mailAddress))
            {
                return;
            }

            char[] separator = new char[2] { ',', ';' };
            string[] addressArray = mailAddress.Split(separator);

            foreach (string address in addressArray)
            {
                if (address.Trim() == string.Empty)
                {
                    continue;
                }

                mailCollection.Add(new MailAddress(address));
            }
        }

        /// <summary>
        /// 字节数组转换为流
        /// </summary>
        /// <param name="byteArray">字节数组</param>
        /// <returns>Stream</returns>
        private static Stream ByteArrayToStream(byte[] byteArray)
        {
            MemoryStream mstream = new MemoryStream(byteArray);

            return mstream;
        }
    }

这是一个邮件助手类，定义成static，无需实例化，直接类名.方法名的形式调用。

只需要上述3个类就可以实现发送Email了，由于上面引用的是web.config里面的信息（asp.net等命名空间，如果是winform等需要自己修改一下），这里还需要配置一下web.config，如下所示：

  <appSettings>
    <!--邮件发送配置-->
    <add key="SMTPSERVER" value="smtp.qq.com"/>
    <!--这是服务器邮箱的地址，如果是新浪，则填 smtp.sina.com-->
    <add key="MAILUSER" value="xxx"/>
    <!--注意！这是对应服务器邮箱的账号-->
    <add key="MAILUSERPW" value="yyy"/>
    <!--注意！这是对应服务器邮箱的账号密码-->
  </appSettings>

最后上一个测试方法，在主函数当中或者Page_Load事件中执行即可：

        private void SendEmailExample()
        {
            MailRequest mail = new MailRequest();
            mail.Subject = "hello,this is a e-mail sent by asp.net mailhelper.";//主题
            mail.Body = "hello,this is a e-mail sent by asp.net mailhelper.<a href='http://blog.csdn.net/guwei4037'>欢迎访问我的博客。</a>";//内容
            mail.Bcc = "512122338@qq.com";//秘密抄送人
            mail.From = "345822155@qq.com";//发送人
            mail.CC = "guwei4037@sina.com";//抄送人
            mail.To = "guwei4037@gmail.com";//收件人

            //读取文件到bytes
            FileStream stream = new FileStream(Path.Combine(Server.MapPath("~"), "doc\\test.txt"), FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read);
            byte[] bytes = new byte[stream.Length];
            stream.Read(bytes, 0, bytes.Length);
            stream.Close();

            //附件
            MailRequestAttachments attachments = new MailRequestAttachments();
            attachments.FileName = "test.txt";
            attachments.FileData = bytes;
            mail.Attachments = new MailRequestAttachments[] { 
                    attachments
                };

            string sendMainResult = "-1";
            if (!string.IsNullOrEmpty(mail.CC.Replace(";", "")) && !string.IsNullOrEmpty(mail.To.Replace(";", "")))
            {
                sendMainResult = MailHelper.SendMail(mail);
            }
            Response.Write(sendMainResult);
        }

发送邮件成功，附件也能正常打开，而且多个用户都收到了电子邮件。截图为证。

源代码下载，请点击这里。