MailAddress Constructor (String^, String^)

 

Initializes a new instance of the MailAddress class using the specified address and display name.

Namespace:   System.Net.Mail
Assembly:  System (in System.dll)

public:
MailAddress(
	String^ address,
	String^ displayName
)

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();
}


.NET Framework
Available since 2.0
Return to top
Show: