MailAddress Kelas

Definisi

Ruang nama:

System.Net.Mail

Rakitan:

System.Net.Mail.dll

Sumber:

MailAddress.cs

Mewakili alamat pengirim atau penerima surat elektronik.

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Warisan

Object

MailAddress

Contoh

Contoh kode berikut menunjukkan pengiriman pesan email dengan menggunakan SmtpClientkelas , MailAddress, dan 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());
    }
}

Keterangan

Kelas MailAddress digunakan oleh SmtpClient kelas dan MailMessage untuk menyimpan informasi alamat untuk pesan email.

Alamat email terdiri dari User nama, nama, Host dan opsional, DisplayName. DisplayName dapat berisi karakter non-ASCII jika Anda mengodekannya.

Kelas MailAddress mendukung format alamat email berikut:

• Format alamat sederhana dari user@host. DisplayName Jika tidak diatur, ini adalah format alamat email yang dihasilkan.

• Format nama tampilan standar yang dikutip dari "display name" <user@host>. DisplayName Jika diatur, ini adalah format yang dihasilkan.

  • Kurung sudut ditambahkan di User sekitar nama dan Host nama, jika ini tidak disertakan. Misalnya, "display name" user@host diubah menjadi "display name" <user@host>.

  • Tanda kutip ditambahkan di DisplayNamesekitar , jika ini tidak disertakan. Misalnya, display name <user@host> diubah menjadi "display name" <user@host>.

  • Karakter Unicode didukung di DisplayName properti .

Dalam dua format ini, elemen berikut diizinkan:

• User Nama dengan tanda kutip. Contohnya,"user name"@host.

• Titik berturut-turut dan berikutnya dalam nama pengguna. Contohnya,user...name..@host.

• Harfiah domain yang dikurung. Contohnya,<user@[my domain]>.

• Komentar. Contohnya,(comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Komentar dihapus sebelum transmisi.

Koma digunakan untuk memisahkan elemen dalam daftar alamat email. Akibatnya, koma tidak boleh digunakan dalam nama tampilan yang tidak dikutip dalam daftar. Alamat email berikut akan diizinkan:

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

Alamat email berikut ini tidak akan diizinkan:

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

Tanda kutip dapat disematkan dalam string yang dikutip, tetapi harus dilewati. Alamat email berikut akan diizinkan:

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

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

Alamat email berikut ini tidak akan diizinkan:

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

Ketika nama pengguna tidak dikutip, semua teks antara awal string (atau koma) dan alamat dianggap sebagai bagian DisplayNamedari , termasuk komentar. Contohnya:

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

MailAddress Meskipun kelas menerima alamat email sebagai valid, server email lain mungkin tidak menerima alamat email.

Kelas MailAddress tidak mendukung format alamat email berikut:

• Nama tampilan campuran yang dikutip dan tidak dikutip. Contohnya,display "name" <user@host>.

• Grup, sebagaimana didefinisikan dalam RFC 2822 Bagian 3.4 yang diterbitkan oleh IETF.

• Format nama pengguna usang dari "user"."name"@host, user."name"@host atau "user".name@host.

Konstruktor

MailAddress(String)	Menginisialisasi instans MailAddress baru kelas menggunakan alamat yang ditentukan.
MailAddress(String, String)	Menginisialisasi instans MailAddress baru kelas menggunakan alamat dan nama tampilan yang ditentukan.
MailAddress(String, String, Encoding)	Menginisialisasi instans MailAddress baru kelas menggunakan alamat, nama tampilan, dan pengodean yang ditentukan.

Properti

Address	Mendapatkan alamat email yang ditentukan ketika instans ini dibuat.
DisplayName	Mendapatkan nama tampilan yang terdiri dari nama tampilan dan informasi alamat yang ditentukan ketika instans ini dibuat.
Host	Mendapatkan bagian host dari alamat yang ditentukan ketika instans ini dibuat.
User	Mendapatkan informasi pengguna dari alamat yang ditentukan ketika instans ini dibuat.

Metode

Equals(Object)	Membandingkan dua alamat email.
GetHashCode()	Mengembalikan nilai hash untuk alamat email.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan representasi string dari instans ini.
TryCreate(String, MailAddress)	Membuat baru MailAddress. Tidak melemparkan pengecualian jika objek tidak dapat dibuat.
TryCreate(String, String, Encoding, MailAddress)	Membuat baru MailAddress. Tidak melemparkan pengecualian jika objek tidak dapat dibuat.
TryCreate(String, String, MailAddress)	Membuat baru MailAddress. Tidak melemparkan pengecualian jika objek tidak dapat dibuat.