MailAddress.MailAddress(String) Constructor

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
)
public MailAddress (
	String address
)
public function MailAddress (
	address : String
)
Not applicable.

Parameters

address

A String that contains an e-mail address.

Exception typeCondition

ArgumentNullException

address is a null reference (Nothing in Visual Basic).

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());
    client.Send(message);
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: