MailAddress.DisplayName Propiedad

Definición

Espacio de nombres:

System.Net.Mail

Ensamblado:

System.Net.Mail.dll

Source:

MailAddress.cs

Obtiene el nombre para mostrar creado a partir del nombre para mostrar y de la información de dirección que se especificaron al crear esta instancia.

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

public string DisplayName { get; }

member this.DisplayName : string

Public ReadOnly Property DisplayName As String

Valor de propiedad

String

Objeto String que contiene el nombre para mostrar; de lo contrario, Empty ("") si no se especificó ningún tipo de información al crear esta instancia.

Ejemplos

En el ejemplo de código siguiente se muestra para DisplayName el destinatario de un mensaje de correo electrónico.

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

Comentarios

Los nombres para mostrar que contienen caracteres no ASCII se devuelven en forma legible. Use el ToString método para obtener la forma codificada de DisplayName.

Algunos programas de software que se usan para leer el correo electrónico muestran el valor de propiedad DisplayName en lugar de, o además, la dirección de correo electrónico.