MailAddress Construtores

Definição

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Inicializa uma nova instância da classe MailAddress.

Sobrecargas

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.

MailAddress(String)

Origem:

MailAddress.cs

Inicializa uma nova instância da classe MailAddress usando o endereço especificado.

public:
 MailAddress(System::String ^ address);

public MailAddress (string address);

new System.Net.Mail.MailAddress : string -> System.Net.Mail.MailAddress

Public Sub New (address As String)

Parâmetros

address

String

Um String que contém um endereço de email.

Exceções

ArgumentNullException

address é null.

ArgumentException

address é Empty ("").

FormatException

address não está em um formato reconhecido.

Exemplos

O exemplo de código a seguir usa esse construtor para criar um MailAddress objeto para o Bcc destinatário de uma mensagem de email.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

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

Comentários

O address parâmetro poderá conter um nome de exibição e o endereço de email associado se você colocar o endereço entre colchetes angulares. Por exemplo:

"Tom Smith <tsmith@contoso.com>"

O espaço em branco é permitido entre o nome de exibição e os colchetes angulares.

A tabela a seguir mostra os valores de propriedade de um MailAddress objeto construído usando o endereço de exemplo anterior.

Propriedade	Valor
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

Origem:

MailAddress.cs

Inicializa uma nova instância da classe MailAddress, usando o endereço e o nome de exibição especificados.

public:
 MailAddress(System::String ^ address, System::String ^ displayName);

public MailAddress (string address, string? displayName);

new System.Net.Mail.MailAddress : string * string -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String)

Parâmetros

address

String

Um String que contém um endereço de email.

displayName

String

Um String que contém o nome de exibição associado ao address. Esse parâmetro pode ser null.

Exceções

ArgumentNullException

address é null.

ArgumentException

address é Empty ("").

FormatException

address não está em um formato reconhecido.

- ou -

address contém caracteres não ASCII.

Exemplos

O exemplo de código a seguir usa esse construtor para criar MailAddress instâncias para o remetente e o destinatário de uma mensagem de email.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

public static void CreateBccTestMessage(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.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

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

Comentários

O espaço em branco à esquerda e à direita no nome de exibição é preservado.

Se displayName contiver caracteres não ASCII, o conjunto de caracteres iso-8859-1 será usado para a displayName codificação. A codificação de caracteres não ASCII é discutida no RFC 1522, que está disponível em https://www.ietf.org/.

Se address contiver um nome de exibição e displayName não null for e não for igual a String.Empty, displayName substituirá o valor especificado em address.

MailAddress(String, String, Encoding)

Origem:

MailAddress.cs

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

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);

public MailAddress (string address, string? displayName, System.Text.Encoding? displayNameEncoding);

new System.Net.Mail.MailAddress : string * string * System.Text.Encoding -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String, displayNameEncoding As Encoding)

Parâmetros

address

String

Um String que contém um endereço de email.

displayName

String

Um String que contém o nome de exibição associado ao address.

displayNameEncoding

Encoding

O Encoding que define o conjunto de caracteres usado para displayName.

Exceções

ArgumentNullException

address é null.

- ou -

displayName é null.

ArgumentException

address é Empty ("").

- ou -

displayName é Empty ("").

FormatException

address não está em um formato reconhecido.

- ou -

address contém caracteres não ASCII.

Exemplos

O exemplo de código a seguir usa esse construtor para criar MailAddress instâncias para o remetente de uma mensagem de email.

// Create a mailing address that includes a UTF8 
// character in the display name.
MailAddress^ from = gcnew MailAddress("jane@contoso.com",
    "Jane " + (wchar_t)0xD8 + " Clayton",
    System::Text::Encoding::UTF8);

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com",
   "Jane " + (char)0xD8+ " Clayton",
System.Text.Encoding.UTF8);

' Create a mailing address that includes a UTF8 character
' in the display name.
Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)

Comentários

O espaço em branco à esquerda e à direita no nome de exibição é preservado.

Se address contiver um nome de exibição e displayName não null for e não for igual a String.Empty, displayName substituirá o valor especificado em address.

O MailAddress método não marcar se o displayName parâmetro for válido. Esse método remove as aspas ao redor não exibidas pela DisplayName propriedade . As aspas serão adicionadas antes da transmissão, exceto onde ASCII ou Unicode é especificado no displayNameEncoding parâmetro . A codificação especificada no displayNameEncoding parâmetro será aplicada à propriedade antes da DisplayName transmissão ASCII ou Unicode é especificada no displayNameEncoding parâmetro . UTF8 será a codificação padrão se nenhuma for especificada.

Para obter mais informações sobre formatos de endereço de email com suporte, consulte MailAddress.