MailMessage Constructors
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.
Initializes a new instance of the MailMessage class.
Overloads
MailMessage() |
Initializes an empty instance of the MailMessage class. |
MailMessage(MailAddress, MailAddress) |
Initializes a new instance of the MailMessage class by using the specified MailAddress class objects. |
MailMessage(String, String) |
Initializes a new instance of the MailMessage class by using the specified String class objects. |
MailMessage(String, String, String, String) |
Initializes a new instance of the MailMessage class. |
MailMessage()
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
Initializes an empty instance of the MailMessage class.
public:
MailMessage();
public MailMessage ();
Public Sub New ()
Remarks
From is set to the value in the network element for mailSettings<smtp> Element (Network Settings), if it exists.
Applies to
MailMessage(MailAddress, MailAddress)
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
Initializes a new instance of the MailMessage class by using the specified MailAddress class objects.
public:
MailMessage(System::Net::Mail::MailAddress ^ from, System::Net::Mail::MailAddress ^ to);
public MailMessage (System.Net.Mail.MailAddress from, System.Net.Mail.MailAddress to);
new System.Net.Mail.MailMessage : System.Net.Mail.MailAddress * System.Net.Mail.MailAddress -> System.Net.Mail.MailMessage
Public Sub New (from As MailAddress, to As MailAddress)
Parameters
- from
- MailAddress
A MailAddress that contains the address of the sender of the email message.
- to
- MailAddress
A MailAddress that contains the address of the recipient of the email message.
Exceptions
from
or to
is malformed.
Examples
The following code example demonstrates calling this constructor.
static void CreateTestMessage3()
{
MailAddress^ to = gcnew MailAddress( L"[email protected]" );
MailAddress^ from = gcnew MailAddress( L"[email protected]" );
MailMessage^ message = gcnew MailMessage( from,to );
message->Subject = L"Using the new SMTP client.";
message->Body = L"Using this new feature, you can send an email message from an application very easily.";
// Use the application or machine configuration to get the
// host, port, and credentials.
SmtpClient^ client = gcnew SmtpClient;
Console::WriteLine( L"Sending an email message to {0} at {1} by using the SMTP host {2}.", to->User, to->Host, client->Host );
client->Send( message );
}
public static void CreateTestMessage3()
{
MailAddress to = new MailAddress("[email protected]");
MailAddress from = new MailAddress("[email protected]");
MailMessage message = new MailMessage(from, to);
message.Subject = "Using the new SMTP client.";
message.Body = @"Using this new feature, you can send an email message from an application very easily.";
// Use the application or machine configuration to get the
// host, port, and credentials.
SmtpClient client = new SmtpClient();
Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.",
to.User, to.Host, client.Host);
client.Send(message);
}
Public Shared Sub CreateTestMessage3()
Dim [to] As MailAddress = New MailAddress("[email protected]")
Dim from As MailAddress = New MailAddress("[email protected]")
Dim message As MailMessage = New MailMessage(from, [to])
message.Subject = "Using the new SMTP client."
message.Body = "Using this new feature, you can send an email message from an application very easily."
'Use the application or machine configuration to get the
' host, port, And credentials.
Dim client As SmtpClient = New SmtpClient()
Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.", [to].User, [to].Host, client.Host)
client.Send(message)
End Sub
Remarks
The From property is initialized using from
and the To property is initialized using to
.
Applies to
MailMessage(String, String)
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
Initializes a new instance of the MailMessage class by using the specified String class objects.
public:
MailMessage(System::String ^ from, System::String ^ to);
public MailMessage (string from, string to);
new System.Net.Mail.MailMessage : string * string -> System.Net.Mail.MailMessage
Public Sub New (from As String, to As String)
Parameters
- to
- String
A String that contains the addresses of the recipients of the email message. Multiple email addresses must be separated with a comma character (",").
Exceptions
from
or to
is malformed.
Examples
The following code example demonstrates calling this constructor.
static void CreateTestMessage2( String^ server )
{
String^ to = L"[email protected]";
String^ from = L"[email protected]";
MailMessage^ message = gcnew MailMessage( from,to );
message->Subject = L"Using the new SMTP client.";
message->Body = L"Using this new feature, you can send an email message from an application very easily.";
SmtpClient^ client = gcnew SmtpClient( server );
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client->UseDefaultCredentials = true;
client->Send( message );
client->~SmtpClient();
}
public static void CreateTestMessage2(string server)
{
string to = "[email protected]";
string from = "[email protected]";
MailMessage message = new MailMessage(from, to);
message.Subject = "Using the new SMTP client.";
message.Body = @"Using this new feature, you can send an email message from an application very easily.";
SmtpClient client = new SmtpClient(server);
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client.UseDefaultCredentials = true;
try
{
client.Send(message);
}
catch (Exception ex)
{
Console.WriteLine("Exception caught in CreateTestMessage2(): {0}",
ex.ToString());
}
}
Public Shared Sub CreateTestMessage2(ByVal server As String)
Dim [to] As String = "[email protected]"
Dim from As String = "[email protected]"
Dim message As MailMessage = New MailMessage(from, [to])
message.Subject = "Using the new SMTP client."
message.Body = "Using this new feature, you can send an email message from an application very easily."
Dim client As SmtpClient = New SmtpClient(server)
' Credentials are necessary if the server requires the client
' to authenticate before it will send email on the client's behalf.
client.UseDefaultCredentials = True
Try
client.Send(message)
Catch ex As Exception
Console.WriteLine("Exception caught in CreateTestMessage2(): {0}", ex.ToString())
End Try
End Sub
Remarks
The From property is initialized using from
and the To property is initialized using to
.
Applies to
MailMessage(String, String, String, String)
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
- Source:
- MailMessage.cs
Initializes a new instance of the MailMessage class.
public:
MailMessage(System::String ^ from, System::String ^ to, System::String ^ subject, System::String ^ body);
public MailMessage (string from, string to, string? subject, string? body);
public MailMessage (string from, string to, string subject, string body);
new System.Net.Mail.MailMessage : string * string * string * string -> System.Net.Mail.MailMessage
Public Sub New (from As String, to As String, subject As String, body As String)
Parameters
- to
- String
A String that contains the addresses of the recipients of the email message. Multiple email addresses must be separated with a comma character (",").
Exceptions
from
or to
is malformed.
Examples
The following code example demonstrates calling this constructor.
static void CreateTimeoutTestMessage( String^ server )
{
String^ to = L"[email protected]";
String^ from = L"[email protected]";
String^ subject = L"Using the new SMTP client.";
String^ body = L"Using this new feature, you can send an email message from an application very easily.";
MailMessage^ message = gcnew MailMessage( from,to,subject,body );
SmtpClient^ client = gcnew SmtpClient( server );
Console::WriteLine( L"Changing time out from {0} to 100.", client->Timeout );
client->Timeout = 100;
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client->Credentials = CredentialCache::DefaultNetworkCredentials;
client->Send( message );
}
public static void CreateTimeoutTestMessage(string server)
{
string to = "[email protected]";
string from = "[email protected]";
string subject = "Using the new SMTP client.";
string body = @"Using this new feature, you can send an email message from an application very easily.";
MailMessage message = new MailMessage(from, to, subject, body);
SmtpClient client = new SmtpClient(server);
Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
client.Timeout = 100;
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client.Credentials = CredentialCache.DefaultNetworkCredentials;
client.Send(message);
}
Public Shared Sub CreateTimeoutTestMessage(ByVal server As String)
Dim [to] As String = "[email protected]"
Dim from As String = "[email protected]"
Dim subject As String = "Using the new SMTP client."
Dim body As String = "Using this new feature, you can send an email message from an application very easily."
Dim message As MailMessage = New MailMessage(from, [to], subject, body)
Dim client As SmtpClient = New SmtpClient(server)
Console.WriteLine("Changing time out from {0} to 100.", client.Timeout)
client.Timeout = 100
' Credentials are necessary if the server requires the client
' to authenticate before it will send email on the client's behalf.
client.Credentials = CredentialCache.DefaultNetworkCredentials
client.Send(message)
End Sub
Remarks
The properties for the new MailMessage object are initialized as follows:
Parameter | Property |
---|---|
from |
From |
to |
To |
subject |
Subject |
body |
Body |
By default, the subject and content are assumed to use the default encoding based on local computer settings. Use the BodyEncoding and SubjectEncoding properties to specify different encodings.