Sdílet prostřednictvím


MailAddress Třída

Definice

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

public ref class MailAddress
public class MailAddress
type MailAddress = class
Public Class MailAddress
Dědičnost
MailAddress

Příklady

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

static void CreateCopyMessage( 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 = "Using the SmtpClient class.";
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   
   // Add a carbon copy recipient.
   MailAddress^ copy = gcnew MailAddress( L"Notification_List@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} by using the SMTP host {1}.", to->Address, client->Host );
   client->Send( message );
   client->~SmtpClient();
}
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řídu MailAddress a používají SmtpClient třídy k MailMessage ukládání informací o adrese pro e-mailové zprávy.

E-mailová adresa se skládá ze User jména, Host jména a volitelně z .DisplayName Může DisplayName obsahovat jiné znaky než ASCII, pokud je zakódujete.

Třída MailAddress podporuje následující formáty e-mailových adres:

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

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

    • Lomené závorky jsou přidány kolem User názvu a Host názvu, pokud nejsou zahrnuty. Například "display name" user@host se změní na "display name" <user@host>.

    • Uvozovky se přidají kolem DisplayName, pokud nejsou zahrnuté. Například display name <user@host> se změní na "display name" <user@host>.

    • Vlastnost podporuje DisplayName znaky Unicode.

V těchto dvou formátech jsou povoleny následující prvky:

  • Název User s uvozovkami. Například, "user name"@host.

  • Po sobě jdoucí a koncové tečky v uživatelských jménech Například, user...name..@host.

  • Literály domény s hranatými závorkami. 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.

K oddělení prvků v seznamu poštovních adres se používá čárka. V důsledku toho by se čárka neměla používat v zobrazovaných názvech bez citovaných seznamů. 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 můžou být vložené do řetězce v uvozovkách, ale musí být uvozené řídicím znakem. 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í uvozováno, veškerý text mezi začátkem řetězce (nebo čárkou) a adresou se považuje za součást DisplayNamesouboru , 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, jiné poštovní servery ji nemusí přijmout.

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

  • Smíšené zobrazované názvy v uvozovávce a bez uvozových čísel. Například, display "name" <user@host>.

  • Skupiny, jak jsou definovány v dokumentu RFC 2822 oddílu 3.4 zveřejněném IETF.

  • Zastaralé formáty "user"."name"@hostuživatelského jména , user."name"@host nebo "user".name@host.

Konstruktory

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í.

Vlastnosti

Address

Získá e-mailovou adresu zadanou při vytvoření této instance.

DisplayName

Získá zobrazovaný název složený ze zobrazované jméno a adresa informace zadané při vytvoření této instance.

Host

Získá hostitel část adresy zadané 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

Equals(Object)

Porovná dvě poštovní adresy.

GetHashCode()

Vrátí hodnotu hash pro poštovní adresu.

GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězcovou reprezentaci této instance.

TryCreate(String, MailAddress)

Vytvoří nový objekt MailAddress. Nevyvolá výjimku, pokud objekt nelze vytvořit.

TryCreate(String, String, Encoding, MailAddress)

Create nový MailAddress. Nevyvolá výjimku, pokud objekt nelze vytvořit.

TryCreate(String, String, MailAddress)

Create nový MailAddress. Nevyvolá výjimku, pokud objekt nelze vytvořit.

Platí pro