MailAddress Konstruktory

Definice

Obor názvů:

System.Net.Mail

Sestavení:

netstandard.dll, System.Net.Mail.dll

Inicializuje novou instanci MailAddress třídy.

Přetížení

Name	Description
MailAddress(String)	Inicializuje novou instanci MailAddress třídy pomocí zadané adresy.
MailAddress(String, String)	Inicializuje novou instanci MailAddress třídy pomocí zadané adresy a zobrazovaného názvu.
MailAddress(String, String, Encoding)	Inicializuje novou instanci MailAddress třídy pomocí zadané adresy, zobrazovaného názvu a kódování.

MailAddress(String)

Zdroj:

MailAddress.cs

Inicializuje novou instanci MailAddress třídy pomocí zadané adresy.

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

A String obsahující e-mailovou adresu.

Výjimky

ArgumentNullException

address je null.

ArgumentException

address je Empty ("").

FormatException

address není v rozpoznaném formátu.

Příklady

Následující příklad kódu používá tento konstruktor k vytvoření MailAddress objektu Bcc pro příjemce e-mailové zprávy.

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

Poznámky

Parametr address může obsahovat zobrazované jméno a přidruženou e-mailovou adresu, pokud adresu uzavřete do úhlových závorek. Například:

"Tom Smith <tsmith@contoso.com>"

Mezi zobrazovaným názvem a úhlovými závorkami je povolené prázdné znaky.

Následující tabulka ukazuje hodnoty vlastností objektu MailAddress vytvořeného pomocí předchozí ukázkové adresy.

Vlastnictví	Hodnota
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

Zdroj:

MailAddress.cs

Inicializuje novou instanci MailAddress třídy pomocí zadané adresy a zobrazovaného názvu.

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

A String obsahující e-mailovou adresu.

displayName

String

A String obsahující zobrazovaný název přidružený address. Tento parametr může být null.

Výjimky

ArgumentNullException

address je null.

ArgumentException

address je Empty ("").

FormatException

address není v rozpoznaném formátu.

nebo

address obsahuje jiné znaky než ASCII.

Příklady

Následující příklad kódu používá tento konstruktor k vytvoření MailAddress instancí pro odesílatele a příjemce e-mailové zprávy.

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

Poznámky

Počáteční a koncové prázdné znaky zobrazeného názvu se zachovají.

Pokud displayName obsahuje jiné znaky než ASCII, použije se pro displayName kódování znaková sada iso-8859-1. Kódování znaků, které nejsou ASCII, je popsáno v DOKUMENTU RFC 1522, který je k dispozici na https://www.ietf.org/adrese .

Pokud address obsahuje zobrazovaný název a displayName není null a není roven String.Empty, displayName přepíše hodnotu zadanou v address.

Konstruktor MailAddress(String, String) nekontroluje, jestli displayName je parametr platný. Tato metoda odebere okolní uvozovky, které vlastnost DisplayName nezobrazuje. Před přenosem se přidají uvozovky. UTF8 kódování se použije na DisplayName vlastnost před přenosem.

MailAddress(String, String, Encoding)

Zdroj:

MailAddress.cs

Inicializuje novou instanci MailAddress třídy pomocí zadané adresy, zobrazovaného názvu a kódování.

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

A String obsahující e-mailovou adresu.

displayName

String

A String obsahující zobrazovaný název přidružený address.

displayNameEncoding

Encoding

Ten Encoding definuje znakové sady použité pro displayName.

Výjimky

ArgumentNullException

address je null.

nebo

displayName je null.

ArgumentException

address je Empty ("").

nebo

displayName je Empty ("").

FormatException

address není v rozpoznaném formátu.

nebo

address obsahuje jiné znaky než ASCII.

Příklady

Následující příklad kódu používá tento konstruktor k vytvoření MailAddress instancí pro odesílatele e-mailové zprávy.

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

Poznámky

Počáteční a koncové prázdné znaky zobrazeného názvu se zachovají.

Pokud address obsahuje zobrazovaný název a displayName není null a není roven String.Empty, displayName přepíše hodnotu zadanou v address.

Konstruktor MailAddress(String, String, Encoding) nekontroluje, jestli displayName je parametr platný. Tato metoda odebere okolní uvozovky, které vlastnost DisplayName nezobrazuje. Uvozovky budou přidány před přenos, s výjimkou případů, kdy ASCII nebo Unicode je zadán v parametru displayNameEncoding . Kódování zadané v parametru displayNameEncodingDisplayName se použije na vlastnost před přenosem ASCII nebo Unicode je zadáno v parametru displayNameEncoding . UTF8 je výchozí kódování, pokud není zadán žádný.

Další informace o podporovaných formátech poštovních adres najdete v tématu MailAddress.