MailAddress Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.Net.Mail

Zestaw:: System.Net.Mail.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Inicjuje nowe wystąpienie klasy MailAddress.

Przeciążenia

MailAddress(String)	Inicjuje MailAddress nowe wystąpienie 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 MailAddress nowe wystąpienie klasy przy użyciu określonego adresu, nazwy wyświetlanej i kodowania.

MailAddress(String)

Źródło:: MailAddress.cs

Źródło:: MailAddress.cs

Źródło:: MailAddress.cs

Inicjuje MailAddress nowe wystąpienie 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

address to 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.

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

Uwagi

Parametr address może zawierać nazwę wyświetlaną i skojarzony adres e-mail, jeśli adres zostanie umieszczony w nawiasach kątowych. Na 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.

Właściwość	Wartość
DisplayName	`"Tom Smith"`
Host	`"contoso.com"`
User	`"tsmith"`
Address	`"tsmith@contoso.com"`

Dotyczy

MailAddress(String, String)

Źródło:: MailAddress.cs

Źródło:: MailAddress.cs

Ź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);

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

address to 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 odbiorcy wiadomości e-mail.

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

Uwagi

Wiodące i końcowe białe znaki w nazwie wyświetlanej są zachowywane.

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 omówiono w dokumencie RFC 1522, który jest dostępny pod adresem https://www.ietf.org/.

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

Dotyczy

MailAddress(String, String, Encoding)

Źródło:: MailAddress.cs

Źródło:: MailAddress.cs

Źródło:: MailAddress.cs

Inicjuje MailAddress nowe wystąpienie 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);

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 programu displayName.

Wyjątki

ArgumentNullException

address to null.

-lub-

displayName to 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 = 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)

Uwagi

Wiodące i końcowe białe znaki w nazwie wyświetlanej są zachowywane.

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

Metoda MailAddress 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órej ASCII lub Unicode jest określony w parametrze displayNameEncoding . Kodowanie określone w parametrze displayNameEncoding zostanie zastosowane do DisplayName właściwości przed przesłaniem ASCII 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.

Dotyczy

Udostępnij za pośrednictwem

MailAddress Konstruktory

Definicja

Przeciążenia

MailAddress(String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

MailAddress(String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

MailAddress(String, String, Encoding)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby