MailMessage Class
Provides properties and methods for constructing an e-mail message. Recommended alternative: System.Net.Mail.
Assembly: System.Web (in System.Web.dll)
| Name | Description | |
|---|---|---|
![]() | MailMessage() | Initializes a new instance of the MailMessage class. Recommended alternative: System.Net.Mail. |
| Name | Description | |
|---|---|---|
![]() | Attachments | Specifies the collection of attachments that are transmitted with the message. Recommended alternative: System.Net.Mail. |
![]() | Bcc | Gets or sets a semicolon-delimited list of email addresses that receive a blind carbon copy (BCC) of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | Body | Gets or sets the body of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | BodyEncoding | Gets or sets the encoding type of the body of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | BodyFormat | Gets or sets the content type of the body of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | Cc | Gets or sets a semicolon-delimited list of e-mail addresses that receive a carbon copy (CC) of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | Fields | Gets a collection of objects that map to Microsoft Collaboration Data Objects (CDO) fields. Recommended alternative: System.Net.Mail. |
![]() | From | Gets or sets the e-mail address of the sender. Recommended alternative: System.Net.Mail. |
![]() | Headers | Specifies the custom headers that are transmitted with the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | Priority | Gets or sets the priority of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | Subject | Gets or sets the subject line of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | To | Gets or sets a semicolon-delimited list of recipient e-mail addresses. Recommended alternative: System.Net.Mail. |
![]() | UrlContentBase | Gets or sets the Content-Base HTTP header, the URL base of all relative URLs used within the HTML-encoded body of the e-mail message. Recommended alternative: System.Net.Mail. |
![]() | UrlContentLocation | Gets or sets the Content-Location HTTP header for the e-mail message. Recommended alternative: System.Net.Mail. |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetType() | |
![]() | MemberwiseClone() | |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
The following example shows how to use the MailMessage class.
Security Note
|
|---|
This control has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview. |
<%-- This example shows how to send a mail message from a Web Forms page using the classes in the System.Web.Mail namespace. --%> <%@ IMPORT namespace="System.Web.Mail" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script language="C#" runat="server"> void Page_Load() { if (!IsPostBack) { txtTo.Text="john@contoso.com"; txtFrom.Text="marsha@contoso.com"; txtCc.Text="fred@contoso.com"; txtBcc.Text="wilma@contoso.com"; txtSubject.Text="Hello"; txtBody.Text="This is a test message."; txtAttach.Text=@"C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Sunset.jpg," + @"C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Winter.jpg"; txtBodyEncoding.Text = Encoding.ASCII.EncodingName; txtBodyFormat.Text="HTML"; txtPriority.Text="Normal"; txtUrlContentBase.Text="http://www.contoso.com/images"; txtUrlContentLocation.Text="http://www.contoso.com/images"; // Name of relay mail server in your domain. txtMailServer.Text="smarthost"; } } void btnSubmit_Click(Object sender, EventArgs e) { string sTo, sFrom, sSubject, sBody; string sAttach, sCc, sBcc, sBodyEncoding; string sBodyFormat, sMailServer, sPriority; string sUrlContentBase, sUrlContentLocation; int iLoop1; sTo = txtTo.Text.Trim(); sFrom = txtFrom.Text.Trim(); sSubject = txtSubject.Text.Trim(); sBody = txtBody.Text.Trim(); sAttach = txtAttach.Text.Trim(); sCc = txtCc.Text.Trim(); sBcc = txtBcc.Text.Trim(); sBodyFormat = txtBodyFormat.Text.Trim(); sBodyEncoding = txtBodyEncoding.Text.Trim(); sPriority = txtPriority.Text.Trim(); sUrlContentBase = txtUrlContentBase.Text.Trim(); sUrlContentLocation = txtUrlContentLocation.Text.Trim(); sMailServer = txtMailServer.Text.Trim(); MailMessage MyMail = new MailMessage(); MyMail.From = sFrom; MyMail.To = sTo; MyMail.Subject = sSubject; MyMail.Body = sBody; MyMail.Cc = sCc; MyMail.Bcc = sBcc; MyMail.UrlContentBase = sUrlContentBase; MyMail.UrlContentLocation = sUrlContentLocation; if (txtBodyEncoding.Text == Encoding.UTF7.EncodingName) MyMail.BodyEncoding = Encoding.UTF7; else if (txtBodyEncoding.Text == Encoding.UTF8.EncodingName) MyMail.BodyEncoding = Encoding.UTF8; else MyMail.BodyEncoding = Encoding.ASCII; switch (sBodyFormat.ToUpper()) { case "HTML": MyMail.BodyFormat = MailFormat.Html; break; default: MyMail.BodyFormat = MailFormat.Text; break; } switch (sPriority.ToUpper()) { case "HIGH": MyMail.Priority = MailPriority.High; break; case "LOW": MyMail.Priority = MailPriority.Low; break; default: MyMail.Priority = MailPriority.Normal; break; } // Build an IList of mail attachments. if (sAttach != "") { char[] delim = new char[] {','}; foreach (string sSubstr in sAttach.Split(delim)) { MailAttachment MyAttachment = new MailAttachment(sSubstr); MyMail.Attachments.Add(MyAttachment); } } SmtpMail.SmtpServer = sMailServer; SmtpMail.Send(MyMail); lblMsg1.Text="C# Message sent to " + MyMail.To; } void btnClear_Click(Object sender, EventArgs e) { lblMsg1.Text=""; txtTo.Text=""; txtFrom.Text=""; txtSubject.Text=""; txtBody.Text=""; txtAttach.Text=""; txtBcc.Text=""; txtCc.Text=""; txtBodyEncoding.Text=""; txtBodyFormat.Text=""; txtPriority.Text=""; txtUrlContentBase.Text=""; txtUrlContentLocation.Text=""; txtMailServer.Text=""; btnSubmit.Text="Submit"; } </script> <html xmlns="http://www.w3.org/1999/xhtml"> <head runat="server"> <title>Mail Form Example</title> </head> <body> <h4>Send a new mail message:</h4> <form id="form1" method="Post" action="MailForm.aspx" runat="server"> <table style="width:350; background-color:#FFFF99"> <tr> <td align="Right"><b>To:</b></td> <td><Asp:Textbox id="txtTo" runat="server"/></td> </tr> <tr> <td align="Right"><b>From:</b></td> <td><Asp:Textbox id="txtFrom" runat="server"/></td> </tr> <tr> <td align="Right"><b>Subject:</b></td> <td><Asp:Textbox id="txtSubject" runat="server"/></td> </tr> <tr> <td align="Right"><b>MessageBody:</b></td> <td><Asp:Textbox id="txtBody" runat="server"/></td> </tr> <tr> <td align="Right"><b>Attachments:</b></td> <td><Asp:Textbox id="txtAttach" runat="server"/></td> </tr> <tr> <td align="Right"><b>CC:</b></td> <td><Asp:Textbox id="txtBcc" runat="server"/></td> </tr> <tr> <td align="Right"><b>BCC:</b></td> <td><Asp:Textbox id="txtCc" runat="server"/></td> </tr> <tr> <td align="Right"><b>BodyEncoding:</b></td> <td><Asp:Textbox id="txtBodyEncoding" runat="server"/></td> </tr> <tr> <td align="Right"><b>BodyFormat:</b></td> <td><Asp:Textbox id="txtBodyFormat" runat="server"/></td> </tr> <tr> <td align="Right"><b>Priority:</b></td> <td><Asp:Textbox id="txtPriority" runat="server"/></td> </tr> <tr> <td align="Right"><b>URL Content Base:</b></td> <td><Asp:Textbox id="txtUrlContentBase" runat="server"/></td> </tr> <tr> <td align="Right"><b>URL Content Location:</b></td> <td><Asp:Textbox id="txtUrlContentLocation" runat="server"/></td> </tr> <tr> <td align="Right"><b>Mail Server:</b></td> <td><Asp:Textbox id="txtMailServer" runat="server"/></td> </tr> </table><br /> <asp:button id="btnSubmit" Text="Submit" OnClick="btnSubmit_Click" runat="server"/> <asp:button id="btnClear" Text="Clear" OnClick="btnClear_Click" runat="server"/> <p><asp:Label id="lblMsg1" runat="server"/></p> </form> </body> </html>
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
.jpeg?cs-save-lang=1&cs-lang=csharp)
.jpeg?cs-save-lang=1&cs-lang=csharp)
.jpeg?cs-save-lang=1&cs-lang=csharp)
.jpeg?cs-save-lang=1&cs-lang=csharp)