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 override string ToString ()
public String ToString ()
public override function ToString () : String
Not applicable.

Return Value

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 a null reference (Nothing in Visual Basic) and not equal to String.Empty (""), ToString returns a string composed using the following syntax:

DisplayName <User@Host>

If DisplayName is a null reference (Nothing in Visual Basic) 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);
    client.Send(message);
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2016 Microsoft