MailAddress Clase

Referencia

Definición

Espacio de nombres:: System.Net.Mail

Ensamblado:: System.Net.Mail.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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: 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 usan la SmtpClient clase para MailMessage 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 son 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 objeto , 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 .
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 debe usarse en nombres para mostrar sin comprimido en una lista. Se permitirían las siguientes direcciones de correo:

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

No se permitiría 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ían las siguientes direcciones de correo:

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

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

No se permitiría 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. Por ejemplo, display "name" <user@host>.
Grupos, tal 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