MailAddress Třída

Definice

Obor názvů:

System.Net.Mail

Sestavení:

netstandard.dll, System.Net.Mail.dll

Zdroj:

MailAddress.cs

Představuje adresu odesílatele elektronické pošty nebo příjemce.

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Dědičnost

Object

MailAddress

Příklady

Následující příklad kódu ukazuje odeslání e-mailové zprávy pomocí SmtpClient, MailAddressa MailMessage třídy.

public static void CreateCopyMessage(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.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an email message from an application very easily.";
    // Add a carbon copy recipient.
    MailAddress copy = new MailAddress("Notification_List@contoso.com");
    message.CC.Add(copy);
    SmtpClient client = new SmtpClient(server);
    // Include credentials if the server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} by using the SMTP host {1}.",
         to.Address, client.Host);

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

Poznámky

Třída MailAddress je používána SmtpClient třídami MailMessage k ukládání informací o adresách pro e-mailové zprávy.

Poštovní adresa se skládá z uživatelského jména, názvu hostitele a volitelného zobrazovaného jména. DisplayName může obsahovat znaky jiné než ASCII, pokud je zakódujete.

Třída MailAddress podporuje následující formáty poštovních adres:

• Jednoduchý formát user@hostadresy . DisplayName Pokud není nastavená, jedná se o formát e-mailové adresy, který se vygeneruje.

• Standardní formát zobrazovaného názvu "display name" <user@host>. DisplayName Pokud je nastavená, jedná se o vygenerovaný formát.

  • Pokud ještě nejsou zahrnuté, kolem názvu a User názvu se přidají Host úhlové závorky. Například "display name" user@host se změní na "display name" <user@host>.
  • Pokud ještě nejsou zahrnuté, uvozovky se přidají kolem DisplayName. Například display name <user@host> se změní na "display name" <user@host>.
  • Ve vlastnosti jsou podporovány DisplayName znaky Unicode.

V těchto dvouformátch

• Název User s uvozovkami. Například: "user name"@host.
• Literály domén v hranatých závorkách Například: <user@[my domain]>.
• Komentáře. Například: (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Komentáře se před přenosem odeberou.
• .NET 9 a starší POUZE: Po sobě jdoucí a koncové tečky v uživatelských jménech. Například: user...name..@host. (Počínaje .NET 10 nejsou povoleny po sobě jdoucí tečky.)

Čárka slouží k oddělení prvků v seznamu poštovních adres. V důsledku toho by se čárka neměla používat v necitovaných zobrazovaných názvech v seznamu. Budou povoleny následující poštovní adresy:

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

Následující e-mailová adresa by nebyla povolena:

John, Doe <user@host>, Bob, Smith <user2@host>

Uvozovky mohou být vloženy do řetězce v uvozovkách, ale musí být uvozené. Budou povoleny následující poštovní adresy:

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

Následující e-mailová adresa by nebyla povolena:

"John "Jr" Doe" <user@host>

Pokud uživatelské jméno není citováno, veškerý text mezi začátkem řetězce (nebo čárkou) a adresou se považuje za součást DisplayName, včetně komentářů. Příklad:

(non comment) unquoted display (non comment) name (non comment) <user@host>

MailAddress I když třída přijímá e-mailovou adresu jako platnou, ostatní poštovní servery nemusí poštovní adresu přijmout.

Třída MailAddress nepodporuje následující formáty poštovních adres:

• Smíšené uvozové a necitované zobrazované názvy. Například: display "name" <user@host>.
• Skupiny definované v dokumentu RFC 2822 Oddíl 3.4 publikované organizací IETF.
• Zastaralé formáty "user"."name"@hostuživatelského jména nebo user."name"@host"user".name@host.
• .NET pouze 10 a novějších verzí: Po sobě jdoucí tečky v uživatelském jménu, například user...name@host.com.

Konstruktory

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

Vlastnosti

Name	Description
Address	Získá e-mailovou adresu zadanou při vytvoření této instance.
DisplayName	Získá zobrazovaný název složený z zobrazovaného názvu a informace o adrese zadané při vytvoření této instance.
Host	Získá část hostitele adresy zadanou při vytvoření této instance.
User	Získá informace o uživateli z adresy zadané při vytvoření této instance.

Metody

Name	Description
Equals(Object)	Porovná dvě poštovní adresy.
GetHashCode()	Vrátí hodnotu hash pro e-mailovou adresu.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězcovou reprezentaci této instance.
TryCreate(String, MailAddress)	Vytvoří novou MailAddress. Nevyvolá výjimku, pokud objekt nelze vytvořit.
TryCreate(String, String, Encoding, MailAddress)	Vytvořte nové MailAddress. Nevyvolá výjimku, pokud objekt nelze vytvořit.
TryCreate(String, String, MailAddress)	Vytvořte nové MailAddress. Nevyvolá výjimku, pokud objekt nelze vytvořit.