MailMessage Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Caution
The recommended alternative is System.Net.Mail.MailMessage. http://go.microsoft.com/fwlink/?linkid=14202
Provides properties and methods for constructing an email message. Recommended alternative: System.Net.Mail.
public ref class MailMessage
public class MailMessage
[System.Obsolete("The recommended alternative is System.Net.Mail.MailMessage. http://go.microsoft.com/fwlink/?linkid=14202")]
public class MailMessage
type MailMessage = class
[<System.Obsolete("The recommended alternative is System.Net.Mail.MailMessage. http://go.microsoft.com/fwlink/?linkid=14202")>]
type MailMessage = class
Public Class MailMessage
- Inheritance
-
MailMessage
- Attributes
Examples
The following example shows how to use the MailMessage class.
Important
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="[email protected]";
txtFrom.Text="[email protected]";
txtCc.Text="[email protected]";
txtBcc.Text="[email protected]";
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>
<%--
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="VB" runat="server">
Sub Page_Load()
If Not IsPostBack Then
lblMsg1.Text = ""
txtTo.Text = "[email protected]"
txtFrom.Text = "[email protected]"
txtCc.Text = "[email protected]"
txtBcc.Text = "[email protected]"
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" '
End If
End Sub
Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim sTo As String, sFrom As String, sSubject As String, sBody As String
Dim sAttach As String, sCc As String, sBcc As String, sBodyEncoding As String
Dim sBodyFormat As String, sMailServer As String, sPriority As String
Dim sUrlContentBase As String, sUrlContentLocation As String
Dim iLoop1 As Integer
sTo = Trim(txtTo.Text)
sFrom = Trim(txtFrom.Text)
sSubject = Trim(txtSubject.Text)
sBody = Trim(txtBody.Text)
sAttach = Trim(txtAttach.Text)
sCc = Trim(txtCc.Text)
sBcc = Trim(txtBcc.Text)
sBodyFormat = Trim(txtBodyFormat.Text)
sBodyEncoding = Trim(txtBodyEncoding.Text)
sPriority = Trim(txtPriority.Text)
sUrlContentBase = Trim(txtUrlContentBase.Text)
sUrlContentLocation = Trim(txtUrlContentLocation.Text)
sMailServer = Trim(txtMailServer.Text)
Dim MyMail As MailMessage = 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
Select Case txtBodyEncoding.Text
Case Encoding.UTF7.EncodingName : MyMail.BodyEncoding = Encoding.UTF7
Case Encoding.UTF8.EncodingName : MyMail.BodyEncoding = Encoding.UTF8
Case Else : MyMail.BodyEncoding = Encoding.ASCII
End Select
Select Case UCase(sBodyFormat)
Case "HTML" : MyMail.BodyFormat = MailFormat.Html
Case Else : MyMail.BodyFormat = MailFormat.Text
End Select
Select Case UCase(sPriority)
Case "HIGH" : MyMail.Priority = MailPriority.High
Case "LOW" : MyMail.Priority = MailPriority.Low
Case Else : MyMail.Priority = MailPriority.Normal
End Select
' Build an IList of mail attachments.
If sAttach <> "" Then
Dim delim As Char = ","
Dim sSubstr As String
For Each sSubstr In sAttach.Split(delim)
Dim myAttachment As MailAttachment = New MailAttachment(sSubstr)
MyMail.Attachments.Add(myAttachment)
Next
End If
SmtpMail.SmtpServer = sMailServer
SmtpMail.Send(MyMail)
lblMsg1.Text = "VB Message sent to " & MyMail.To
End Sub
Sub btnClear_Click(ByVal sender As Object, ByVal e As EventArgs)
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"
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Send a new mail message:</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>
Constructors
MailMessage() |
Initializes a new instance of the MailMessage class. Recommended alternative: System.Net.Mail. |
Properties
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 email message. Recommended alternative: System.Net.Mail. |
Body |
Gets or sets the body of the email message. Recommended alternative: System.Net.Mail. |
BodyEncoding |
Gets or sets the encoding type of the body of the email message. Recommended alternative: System.Net.Mail. |
BodyFormat |
Gets or sets the content type of the body of the email message. Recommended alternative: System.Net.Mail. |
Cc |
Gets or sets a semicolon-delimited list of email addresses that receive a carbon copy (CC) of the email 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 email address of the sender. Recommended alternative: System.Net.Mail. |
Headers |
Specifies the custom headers that are transmitted with the email message. Recommended alternative: System.Net.Mail. |
Priority |
Gets or sets the priority of the email message. Recommended alternative: System.Net.Mail. |
Subject |
Gets or sets the subject line of the email message. Recommended alternative: System.Net.Mail. |
To |
Gets or sets a semicolon-delimited list of recipient email addresses. Recommended alternative: System.Net.Mail. |
UrlContentBase |
Gets or sets the |
UrlContentLocation |
Gets or sets the |
Methods
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
GetType() |
Gets the Type of the current instance. (Inherited from Object) |
MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
ToString() |
Returns a string that represents the current object. (Inherited from Object) |