This documentation is archived and is not being maintained.

MailAddress.ToString Method

Returns a string representation of this instance.

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

public override string ToString()

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.

Display names that contain non-ASCII characters are returned in their encoded form. Encoding non-ASCII characters is discussed in RFC 1522 available at http://www.ietf.org.

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

		public static void CreateTestMessage4(string server)
		{
			MailAddress from = new MailAddress("ben@contoso.com");
			MailAddress to = new MailAddress("Jane@contoso.com");
			MailMessage message = new MailMessage(from, to);
			message.Subject = "Using the SmtpClient class.";
			message.Body = @"Using this feature, you can send an e-mail message from an application very easily.";
			SmtpClient client = new SmtpClient(server);
			Console.WriteLine("Sending an e-mail message to {0} by using SMTP host {1} port {2}.",
				 to.ToString(), client.Host, client.Port);

      try {
			  client.Send(message);
			}
			catch (Exception ex) {
			  Console.WriteLine("Exception caught in CreateTestMessage4(): {0}", 
                    ex.ToString() );			  
		  }
		}
public:
    static void CreateTestMessage4(String* server)
    {
       MailAddress* from = new MailAddress(S"ben@contoso.com");
       MailAddress* to = new MailAddress(S"Jane@contoso.com");
       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.";
        SmtpClient* client = new SmtpClient(server);
        Console::WriteLine(S"Sending an e-mail message to {0} by using SMTP host {1} port {2}.", 
             to, client->Host, __box(client->Port));
        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.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: