MailAddress Construtores

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

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

Exceções

Exemplos

O exemplo de código seguinte utiliza este construtor para criar um MailAddress objeto para o Bcc destinatário de uma mensagem de email.

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());
    }
}

Observações

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

"Tom Smith <tsmith@contoso.com>"

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

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

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

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

public MailAddress(string address, 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

Exceções

Exemplos

O exemplo de código seguinte utiliza este construtor para criar MailAddress instâncias para o remetente e destinatário de uma mensagem de email.

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());
    }
}

Observações

O espaço em branco inicial e posterior no nome de exibição está preservado.

Se displayName contiver caracteres não ASCII, o conjunto de caracteres iso-8859-1 é 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 sobrepõe-se ao valor especificado em address.

O MailAddress(String, String) construtor não verifica se o displayName parâmetro é válido. Este método remove as cotações circundantes que não são apresentadas pela DisplayName propriedade. As cotações serão adicionadas antes da transmissão. UTF8 a codificação será aplicada à DisplayName propriedade antes da transmissão.

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

Origem:

MailAddress.cs

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

public MailAddress(string address, 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

Exceções

Exemplos

O exemplo de código seguinte utiliza este 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 = 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)

Observações

O espaço em branco inicial e posterior no nome de exibição está preservado.

Se address contiver um nome de exibição, e displayName não null for e não for igual a String.Empty, displayName sobrepõe-se ao valor especificado em address.

O MailAddress(String, String, Encoding) construtor não verifica se o displayName parâmetro é válido. Este método remove as cotações circundantes que não são apresentadas pela DisplayName propriedade. As cotações serão adicionadas antes da transmissão, exceto quando ASCII ou Unicode for especificado no displayNameEncoding parâmetro. A codificação especificada no displayNameEncoding parâmetro será aplicada à DisplayName propriedade antes da transmissão ASCII ou Unicode é especificada no displayNameEncoding parâmetro. UTF8 é a codificação padrão se nenhuma for especificada.

Para mais informações sobre formatos de endereços de correio suportados, consulte MailAddress.