MailAddress Constructor (String)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the MailAddress class using the specified address.

Namespace:   System.Net.Mail
Assembly:  System (in System.dll)

public MailAddress(
	string address
)

Parameters

address
Type: System.String

A String that contains an e-mail address.

Exception Condition
ArgumentNullException

address is null.

ArgumentException

address is String.Empty ("").

FormatException

address is not in a recognized format.

The address parameter can contain a display name and the associated e-mail address if you enclose the address in angle brackets. For example:

"Tom Smith <tsmith@contoso.com>"

White space is permitted between the display name and the angle brackets.

The following table shows the property values for a MailAddress object constructed using the preceding example address.

Property

Value

DisplayName

"Tom Smith"

Host

"contoso.com"

User

"tsmith"

Address

"tsmith@contoso.com"

The following code example uses this constructor to create a MailAddress object for the Bcc recipient of an e-mail message.

public static void CreateBccTestMessage(string server)
{
	MailAddress from = new MailAddress("ben@contoso.com", "Ben Miller");
	MailAddress to = new MailAddress("jane@contoso.com", "Jane Clayton");
	MailMessage message = new MailMessage(from, to);
	message.Subject = "Using the SmtpClient class.";
	message.Body = @"Using this feature, you can send an e-mail message from an application very easily.";
	MailAddress bcc = new MailAddress("manager1@contoso.com");
	message.Bcc.Add(bcc);
	SmtpClient client = new SmtpClient(server);
	client.Credentials = CredentialCache.DefaultNetworkCredentials;
	Console.WriteLine("Sending an e-mail message to {0} and {1}.", 
	    to.DisplayName, message.Bcc.ToString());
    try {
      client.Send(message);
    }  
    catch (Exception ex) {
      Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}", 
                  ex.ToString() );
	  }
	}

.NET Framework
Available since 2.0
Return to top
Show: