MailAddress Constructor (String)
Initializes a new instance of the MailAddress class using the specified address.
Assembly: System (in System.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | address is nullptr. |
| 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 |
|---|---|
"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.
static void CreateBccTestMessage( String^ server ) { MailAddress^ from = gcnew MailAddress( L"ben@contoso.com",L"Ben Miller" ); MailAddress^ to = gcnew MailAddress( L"jane@contoso.com",L"Jane Clayton" ); MailMessage^ message = gcnew MailMessage( from,to ); message->Subject = L"Using the SmtpClient class."; message->Body = L"Using this feature, you can send an e-mail message from an application very easily."; MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" ); message->Bcc->Add( bcc ); SmtpClient^ client = gcnew SmtpClient( server ); client->Credentials = CredentialCache::DefaultNetworkCredentials; Console::WriteLine( L"Sending an e-mail message to {0} and {1}.", to->DisplayName, message->Bcc ); try { client->Send( message ); } catch ( Exception^ ex ) { Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", ex->ToString() ); } client->~SmtpClient(); }
public:
static void CreateBccTestMessage(String* server)
{
MailAddress* from = new MailAddress(S"ben@contoso.com", S"Ben Miller");
MailAddress* to = new MailAddress(S"jane@contoso.com", S"Jane Clayton");
MailMessage* message = new MailMessage(from, to);
message->Subject = S"Using the SmtpClient class.";
message->Body = S"Using this feature, you can send an e-mail message from an application very easily.";
MailAddress* bcc= new MailAddress(S"manager1@contoso.com");
message->Bcc->Add(bcc);
SmtpClient* client = new SmtpClient(server);
client->Credentials = CredentialCache::DefaultNetworkCredentials;
Console::WriteLine(S"Sending an e-mail message to {0} and {1}.", to->DisplayName, message->Bcc);
client->Send(message);
client->Dispose();
}
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.