ToString Method
Collapse the table of content
Expand the table of content

MailAddress::ToString Method ()

 

Returns a string representation of this instance.

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

public:
virtual String^ ToString() override

Return Value

Type: System::String^

A String that contains the contents of this MailAddress.

The string returned by this method is not necessarily identical to the string specified when the instance was created. If the DisplayName property is not null and not equal to String::Empty (""), ToString returns a string composed using the following syntax:

DisplayName <User@Host>

If DisplayName is null or is equal to String::Empty, ToString returns the value of the Address property.

The following code example displays the destination of an e-mail message.

static void CreateTestMessage4( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailAddress^ to = gcnew MailAddress( L"Jane@contoso.com" );
   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.";
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"Sending an e-mail message to {0} by using SMTP host {1} port {2}.", to, client->Host, client->Port );
   client->Send( message );
   client->~SmtpClient();
}


.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft