MailAddress Constructor (String^, String^)
Initializes a new instance of the MailAddress class using the specified address and display name.
Assembly: System (in System.dll)
Parameters
- address
-
Type:
System::String^
A String that contains an e-mail address.
- displayName
-
Type:
System::String^
A String that contains the display name associated with address. This parameter can be null.
| Exception | Condition |
|---|---|
| ArgumentNullException | address is null. |
| ArgumentException | address is String::Empty (""). |
| FormatException | address is not in a recognized format. -or- address contains non-ASCII characters. |
Leading and trailing white space in the display name is preserved.
If displayName contains non-ASCII characters, the iso-8859-1 character set is used for the displayName encoding. Encoding non-ASCII characters is discussed in RFC 1522, which is available at http://www.ietf.org.
If address contains a display name, and displayName is not null and is not equal to String::Empty, displayName overrides the value specified in address.
The following code example uses this constructor to create MailAddress instances for the sender and 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(); }
Available since 2.0