MailAddress.DisplayName Propriété

Définition

Espace de noms:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Source:

MailAddress.cs

Obtient le nom complet composé à partir du nom complet et des informations d'adresse spécifiés quand cette instance a été créée.

public:
 property System::String ^ DisplayName { System::String ^ get(); };

public string DisplayName { get; }

member this.DisplayName : string

Public ReadOnly Property DisplayName As String

Valeur de propriété

String

String qui contient le nom complet ; sinon, Empty ("") si aucune information de nom complet n'a été spécifiée quand cette instance a été créée.

Exemples

L’exemple de code suivant affiche le DisplayName pour le destinataire d’un e-mail.

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

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

Remarques

Les noms d’affichage qui contiennent des caractères non ASCII sont retournés sous forme lisible par l’homme. Utilisez la ToString méthode pour obtenir la forme encodée du DisplayName.

Certains logiciels utilisés pour lire les e-mails affichent la valeur de la DisplayName propriété au lieu ou en plus de l’adresse e-mail.