MailAddress Classe

Referência

Definição

Namespace:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa o endereço de um remetente ou destinatário de email.

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 o SmtpClient, MailAddresse MailMessage as classes.

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 classes e MailMessage pelas SmtpClient classes para armazenar informações de endereço para mensagens de email.

Um endereço de email é composto por um User nome, Host nome e, opcionalmente, um DisplayName. A DisplayName opção pode conter caracteres não ASCII se você os codificar.

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 com 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 nome, se eles não estiverem incluídos. Por exemplo, "display name" user@host é alterado para "display name" <user@host>.
As aspas serão adicionadas ao redor do 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.
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 são considerados 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 mistos entre aspas e não citados. 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"@host, user."name"@host ou "user".name@host.

Construtores

MailAddress(String)	Inicializa uma nova instância da classe MailAddress usando o endereço especificado.
MailAddress(String, String)	Inicializa uma nova instância da classe MailAddress, usando o endereço e o nome de exibição especificados.
MailAddress(String, String, Encoding)	Inicializa uma nova instância da classe MailAddress usando o endereço especificado, o nome de exibição e a codificação.

Propriedades

Address	Obtém o endereço de email especificado quando essa instância foi criada.
DisplayName	Obtém o nome de exibição composto do nome de exibição e das informações de endereço especificadas quando essa instância foi criada.
Host	Obtém a parte de host do endereço especificado quando esta instância foi criada.
User	Obtém as informações do usuário do endereço especificado quando essa instância foi criada.

Métodos

Equals(Object)	Compara dois endereços de email.
GetHashCode()	Retorna um valor de hash para um endereço de email.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma representação de cadeia de caracteres dessa instância.
TryCreate(String, MailAddress)	Cria um novo MailAddress. Não gerará uma exceção se o objeto não puder ser criado.
TryCreate(String, String, Encoding, MailAddress)	Crie um novo MailAddress. Não gerará uma exceção se o objeto não puder ser criado.
TryCreate(String, String, MailAddress)	Crie um novo MailAddress. Não gerará uma exceção se o objeto não puder ser criado.

Aplica-se a