MailAddress Konstruktorów

Definicja

Namespace:

System.Net.Mail

Zestawów:

netstandard.dll, System.Net.Mail.dll

Inicjuje nowe wystąpienie klasy MailAddress.

Przeciążenia

Nazwa	Opis
MailAddress(String)	Inicjuje nowe wystąpienie MailAddress klasy przy użyciu określonego adresu.
MailAddress(String, String)	Inicjuje MailAddress nowe wystąpienie klasy przy użyciu określonego adresu i nazwy wyświetlanej.
MailAddress(String, String, Encoding)	Inicjuje nowe wystąpienie MailAddress klasy przy użyciu określonego adresu, nazwy wyświetlanej i kodowania.

MailAddress(String)

Źródło:

MailAddress.cs

Inicjuje nowe wystąpienie MailAddress klasy przy użyciu określonego adresu.

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)

Parametry

address

String

Element String zawierający adres e-mail.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

ArgumentException

address is Empty ("").

FormatException

address nie jest w rozpoznanym formacie.

Przykłady

Poniższy przykład kodu używa tego konstruktora do utworzenia MailAddress obiektu dla Bcc adresata wiadomości e-mail.

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

Uwagi

Parametr address może zawierać nazwę wyświetlaną i skojarzony adres e-mail, jeśli adres zostanie umieszczony w nawiasach kątowych. Przykład:

"Tom Smith <tsmith@contoso.com>"

Odstęp między nazwą wyświetlaną a nawiasami kątowymi jest dozwolony.

W poniższej tabeli przedstawiono wartości właściwości obiektu MailAddress skonstruowanego przy użyciu poprzedniego przykładowego adresu.

Majątek	Wartość
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

Źródło:

MailAddress.cs

Inicjuje MailAddress nowe wystąpienie klasy przy użyciu określonego adresu i nazwy wyświetlanej.

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)

Parametry

address

String

Element String zawierający adres e-mail.

displayName

String

Element String zawierający nazwę wyświetlaną skojarzona z elementem address. Ten parametr może mieć wartość null.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

ArgumentException

address is Empty ("").

FormatException

address nie jest w rozpoznanym formacie.

— lub —

address zawiera znaki inne niż ASCII.

Przykłady

Poniższy przykład kodu używa tego konstruktora do tworzenia MailAddress wystąpień dla nadawcy i adresata wiadomości e-mail.

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

Uwagi

Zachowano wiodące i końcowe białe znaki w nazwie wyświetlanej.

Jeśli displayName zawiera znaki inne niż ASCII, zestaw znaków iso-8859-1 jest używany do displayName kodowania. Kodowanie znaków innych niż ASCII jest omawiane w dokumencie RFC 1522, który jest dostępny pod adresem https://www.ietf.org/.

Jeśli address zawiera nazwę wyświetlaną i displayName nie null jest równa String.Empty, displayName zastępuje wartość określoną w pliku address.

Konstruktor MailAddress(String, String) nie sprawdza, czy displayName parametr jest prawidłowy. Ta metoda usuwa otaczające cudzysłowy, które nie są wyświetlane przez DisplayName właściwość . Oferty zostaną dodane przed transmisją. UTF8 kodowanie zostanie zastosowane do właściwości przed przesłaniem DisplayName .

MailAddress(String, String, Encoding)

Źródło:

MailAddress.cs

Inicjuje nowe wystąpienie MailAddress klasy przy użyciu określonego adresu, nazwy wyświetlanej i kodowania.

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)

Parametry

address

String

Element String zawierający adres e-mail.

displayName

String

Element String zawierający nazwę wyświetlaną skojarzona z elementem address.

displayNameEncoding

Encoding

Element Encoding definiujący zestaw znaków używany dla elementu displayName.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

— lub —

Parametr displayName ma wartość null.

ArgumentException

address is Empty ("").

— lub —

displayName is Empty ("").

FormatException

address nie jest w rozpoznanym formacie.

— lub —

address zawiera znaki inne niż ASCII.

Przykłady

Poniższy przykład kodu używa tego konstruktora do tworzenia MailAddress wystąpień dla nadawcy wiadomości e-mail.

// 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)

Uwagi

Zachowano wiodące i końcowe białe znaki w nazwie wyświetlanej.

Jeśli address zawiera nazwę wyświetlaną i displayName nie null jest równa String.Empty, displayName zastępuje wartość określoną w pliku address.

Konstruktor MailAddress(String, String, Encoding) nie sprawdza, czy displayName parametr jest prawidłowy. Ta metoda usuwa otaczające cudzysłowy, które nie są wyświetlane przez DisplayName właściwość . Cudzysłowy zostaną dodane przed transmisją, z wyjątkiem sytuacji, w których ASCII lub Unicode jest określony w parametrze displayNameEncoding . Kodowanie określone w parametrze displayNameEncoding zostanie zastosowane do właściwości przed transmisją DisplayNameASCII lub Unicode jest określone w parametrze displayNameEncoding . UTF8 jest domyślnym kodowaniem, jeśli nie określono żadnego.

Aby uzyskać więcej informacji na temat obsługiwanych formatów adresów e-mail, zobacz MailAddress.