MailAddress Classe

Definição

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Herança

Object

MailAddress

Exemplos

O exemplo de código a seguir demonstra o envio de uma mensagem de email usando as SmtpClientclasses , MailAddresse 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());
    }
}

Comentários

A MailAddress classe é usada pelas SmtpClient classes e MailMessage para armazenar informações de endereço para mensagens de email.

Um endereço de email é composto por um User nome, um nome e, Host opcionalmente, um DisplayName. O DisplayName poderá conter caracteres não ASCII se você codificá-los.

A MailAddress classe dá suporte aos seguintes formatos de endereço de email:

• Um formato de endereço simples de user@host. Se um DisplayName não estiver definido, esse será o formato de endereço de email gerado.

• Um formato de nome de exibição entre aspas padrão de "display name" <user@host>. Se um DisplayName for definido, esse será o formato gerado.

  • Colchetes angulares serão adicionados ao redor do User nome e Host do nome, se eles não estiverem incluídos. Por exemplo, "display name" user@host é alterado para "display name" <user@host>.

  • Aspas serão adicionadas ao redor de DisplayName, se elas não estiverem incluídas. Por exemplo, display name <user@host> é alterado para "display name" <user@host>.

  • Há suporte para caracteres Unicode na DisplayName propriedade .

Nesses dois formatos, os seguintes elementos são permitidos:

• Um User nome com aspas. Por exemplo, "user name"@host.

• Pontos consecutivos e à direita em nomes de usuário. Por exemplo, user...name..@host.

• Literais de domínio entre colchetes. Por exemplo, <user@[my domain]>.

• Comentários. Por exemplo, (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Os comentários são removidos antes da transmissão.

Uma vírgula é usada para separar elementos em uma lista de endereços de email. Como resultado, uma vírgula não deve ser usada em nomes de exibição não citados em uma lista. Os seguintes endereços de email seriam permitidos:

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

O seguinte endereço de email não seria permitido:

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

As aspas podem ser inseridas em uma cadeia de caracteres entre aspas, mas devem ser escapadas. Os seguintes endereços de email seriam permitidos:

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

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

O seguinte endereço de email não seria permitido:

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

Quando o nome de usuário não é citado, todo o texto entre o início da cadeia de caracteres (ou vírgula) e o endereço é considerado parte do DisplayName, incluindo comentários. Por exemplo:

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

Embora a MailAddress classe aceite um endereço de email como válido, outros servidores de email podem não aceitar o endereço de email.

A MailAddress classe não dá suporte aos seguintes formatos de endereço de email:

• Nomes de exibição entre aspas e sem aspas. Por exemplo, display "name" <user@host>.

• Grupos, conforme definido na Seção 3.4 do RFC 2822 publicada pelo IETF.

• Os formatos de nome de usuário obsoletos de "user"."name"@hostou user."name"@host"user".name@host.

Construtores

Propriedades

Métodos

Aplica-se a