MailAddress Constructor (String^)
.NET Framework (current version)
Initializes a new instance of the MailAddress class using the specified address.
Assembly: System (in System.dll)
| 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 |
|---|---|
"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(); }
.NET Framework
Available since 2.0
Available since 2.0
Show: