MailAddress Constructor (String)
Assembly: System (in system.dll)
| Exception type | Condition |
|---|---|
| address is a null reference (Nothing in Visual Basic). | |
| address is String.Empty (""). | |
| 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 |
|---|---|
| "Tom Smith" | |
| "contoso.com" | |
| "tsmith" | |
| "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 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.