MailAddress Clase

Definición

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Herencia

Object

MailAddress

Ejemplos

En el ejemplo de código siguiente se muestra cómo enviar un mensaje de correo electrónico mediante las SmtpClientclases , MailAddressy MailMessage .

static void CreateCopyMessage( 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 = "Using the SmtpClient class.";
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   
   // Add a carbon copy recipient.
   MailAddress^ copy = gcnew MailAddress( L"Notification_List@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} by using the SMTP host {1}.", to->Address, client->Host );
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateCopyMessage(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.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an email message from an application very easily.";
    // Add a carbon copy recipient.
    MailAddress copy = new MailAddress("Notification_List@contoso.com");
    message.CC.Add(copy);
    SmtpClient client = new SmtpClient(server);
    // Include credentials if the server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} by using the SMTP host {1}.",
         to.Address, client.Host);

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateCopyMessage(): {0}",
            ex.ToString());
    }
}

Comentarios

Las MailAddress clases y MailMessage usan la SmtpClient clase para almacenar la información de direcciones de los mensajes de correo electrónico.

Una dirección de correo se compone de un User nombre, Host un nombre y, opcionalmente, un .DisplayName DisplayName Puede contener caracteres que no sean ASCII si los codifica.

La MailAddress clase admite los siguientes formatos de dirección de correo:

• Formato de dirección simple de user@host. Si no se establece , DisplayName se trata del formato de dirección de correo generado.

• Formato de nombre para mostrar entre comillas estándar de "display name" <user@host>. Si se establece un DisplayName , este es el formato generado.

  • Los corchetes angulares se agregan alrededor del nombre y Host el User nombre, si no se incluyen. Por ejemplo, "display name" user@host se cambia a "display name" <user@host>.

  • Las comillas se agregan alrededor de DisplayName, si no se incluyen. Por ejemplo, display name <user@host> se cambia a "display name" <user@host>.

  • Los caracteres Unicode se admiten en la DisplayName propiedad .

Dentro de estos dos formatos, se permiten los siguientes elementos:

• Un User nombre con comillas. Por ejemplo, "user name"@host.

• Puntos consecutivos y finales en los nombres de usuario. Por ejemplo, user...name..@host.

• Literales de dominio entre corchetes. Por ejemplo, <user@[my domain]>.

• Comentarios. Por ejemplo, (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Los comentarios se quitan antes de la transmisión.

Una coma se usa para separar los elementos de una lista de direcciones de correo. Como resultado, una coma no se debe usar en nombres para mostrar sin comcomprimido en una lista. Se permitirán las siguientes direcciones de correo:

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

No se permitirá la siguiente dirección de correo:

John, Doe <user@host>, Bob, Smith <user2@host>

Las comillas se pueden incrustar en una cadena entre comillas, pero deben ser de escape. Se permitirán las siguientes direcciones de correo:

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

No se permitirá la siguiente dirección de correo:

"John "Jr" Doe" <user@host>

Cuando el nombre de usuario no está entre comillas, todo el texto entre el inicio de la cadena (o coma) y la dirección se consideran parte de DisplayName, incluidos los comentarios. Por ejemplo:

(non comment) unquoted display (non comment) name (non comment) <user@host>

Aunque la MailAddress clase acepta una dirección de correo como válida, es posible que otros servidores de correo no acepten la dirección de correo.

La MailAddress clase no admite los siguientes formatos de dirección de correo:

• Nombres para mostrar entre comillas y sin comillas mixtas. Por ejemplo, display "name" <user@host>.

• Grupos, tal y como se define en la sección 3.4 de RFC 2822 publicada por el IETF.

• Formatos de nombre de usuario obsoletos de "user"."name"@host, user."name"@host o "user".name@host.

Constructores

Propiedades

Métodos

Se aplica a