Export (0) Print
Expand All

MailAddress.DisplayName Property

Gets the display name composed from the display name and address information specified when this instance was created.

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

public string DisplayName { get; }

Property Value

Type: System.String
A String that contains the display name; otherwise, String.Empty ("") if no display name information was specified when this instance was created.

Display names that contain non-ASCII characters are returned in human-readable form. Use the ToString method to get the encoded form of the DisplayName.

Some software programs that are used to read e-mail display the DisplayName property value instead of, or in addition to, the e-mail address.

The following code example displays the DisplayName for the recipient of an e-mail message.

		public static void CreateBccTestMessage(string server)
		{
			MailAddress from = new MailAddress("ben@contoso.com", "Ben Miller");
			MailAddress to = new MailAddress("jane@contoso.com", "Jane Clayton");
			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.";
			MailAddress bcc = new MailAddress("manager1@contoso.com");
			message.Bcc.Add(bcc);
			SmtpClient client = new SmtpClient(server);
			client.Credentials = CredentialCache.DefaultNetworkCredentials;
			Console.WriteLine("Sending an e-mail message to {0} and {1}.", 
			    to.DisplayName, message.Bcc.ToString());
      try {
        client.Send(message);
      }  
      catch (Exception ex) {
        Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}", 
                    ex.ToString() );
  	  }
  	}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft