MailAddress Clase

Definición

Representa la dirección de un remitente o destinatario de correo electrónico.

public ref class MailAddress
public class MailAddress
type MailAddress = class
Public Class MailAddress
Herencia
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

MailAddress(String)

Inicializa una nueva instancia de la clase MailAddress usando la dirección especificada.

MailAddress(String, String)

Inicializa una nueva instancia de la clase MailAddress usando la dirección y el nombre para mostrar especificados.

MailAddress(String, String, Encoding)

Inicializa una nueva instancia de la clase MailAddress utilizando la dirección, el nombre para mostrar y la codificación que se hayan especificado.

Propiedades

Address

Obtiene la dirección de correo electrónico especificada en el momento de crear esta instancia.

DisplayName

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.

Host

Obtiene la parte correspondiente al host de la dirección que se especificó al crear esta instancia.

User

Obtiene la información de usuario a partir de la dirección que se especificó al crear esta instancia.

Métodos

Equals(Object)

Compara dos direcciones de correo.

GetHashCode()

Devuelve un valor hash de una dirección de correo.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una representación en forma de cadena de esta instancia.

TryCreate(String, MailAddress)

Crea un nuevo MailAddress. No inicia una excepción si no se puede crear el objeto.

TryCreate(String, String, Encoding, MailAddress)

Cree un nuevo objeto MailAddress. No inicia una excepción si no se puede crear el objeto.

TryCreate(String, String, MailAddress)

Cree un nuevo objeto MailAddress. No inicia una excepción si no se puede crear el objeto.

Se aplica a