Membuat dan mengatur isi Email

Buat Pesan Email Baru

Kelas MailMessage mewakili sebuah pesan email dan memungkinkan pengembang membuat pesan email baru. Properti email dasar seperti From, To, Subject, dan body dapat dengan mudah dilampirkan ke pesan email yang baru dibuat. Demikian pula, kita dapat menyimpan pesan email ke dalam format berbeda seperti EML, MSG, dan MHTML.

  • Buat sebuah instance dari kelas MailMessage.
  • Atur properti pesan email.
  • Simpan pesan email dalam format yang berbeda.

Potongan kode berikut menunjukkan cara membuat email baru dengan properti yang berbeda.

Menentukan Beberapa Penerima

MailMessage mewakili sebuah pesan email. Instance kelas MailMessage digunakan untuk membangun pesan email yang dikirim ke server SMTP menggunakan kelas SmtpClient. Topik ini menunjukkan cara menentukan lebih dari satu alamat email. Alamat email dapat ditentukan menggunakan kelas MailMessage. Alamat email yang digunakan dalam kelas MailMessage adalah:

  • To - Alamat penerima dapat ditentukan dalam bidang ‘To’. Penerima bidang ‘To’ adalah audiens utama pesan. Bisa ada lebih dari satu alamat penerima.
  • Cc - CC adalah singkatan dari "carbon copy" atau "courtesy copy", dan memungkinkan Anda menambahkan penerima email yang perlu melihat email tetapi tidak harus mengambil tindakan. Misalnya manajer, atau anggota tim Anda yang perlu mengetahui percakapan. Dengan Aspose.Email, alamat CC dapat ditentukan dalam kode Anda. Dengan cara ini, email otomatis, atau semua email ke alamat tertentu, dapat disalin ke personel terkait.
  • Bcc - Bcc, blind carbon copy, memungkinkan Anda mengirim email ke penerima yang disembunyikan dari penerima lain. Di mana CC muncul dalam informasi email yang dilihat penerima utama, Bcc tidak. Ini dimaksudkan untuk notifikasi tersembunyi. 

Untuk menentukan beberapa alamat email dalam sebuah pesan email, ikuti langkah-langkah berikut:

  1. Buat sebuah instance dari kelas MailMessage.
  2. Tentukan alamat From serta banyak alamat To, Cc, dan Bcc menggunakan instance MailMessage.
  3. Buat sebuah instance dari kelas SmtpClient dan kirim email menggunakan metode Send.

Contoh kode di bawah ini menunjukkan cara menentukan beberapa alamat To, CC, dan BCC.

Mengubah alamat email menjadi nama ramah

Contoh kode di bawah menunjukkan cara mengubah alamat email menjadi nama yang mudah dipahami dalam pesan email. Nama yang mudah dipahami adalah nama yang lebih bersahabat bagi manusia daripada alamat email, misalnya John Smith alih-alih js346@domain.com. Saat mengirim email, kita dapat mengaitkan nama yang mudah dipahami dengan alamat email dalam konstruktor kelas MailMessage.

Untuk mengubah alamat email menjadi nama ramah dalam pesan email, ikuti langkah-langkah berikut:

  • Buat sebuah instance dari kelas MailMessage dan tentukan alamat email dalam bidang To dan From beserta nama ramah.
  • Tentukan alamat email Cc dan Bcc beserta nama ramah dengan memanggil konstruktor kelas MailMessage dalam instance MailMessage.
  • Buat sebuah instance dari kelas SmtpClient dan kirim email menggunakan metode Send.

Potongan kode berikut menunjukkan cara menampilkan Nama untuk alamat email.

Atur Badan Email

Kelas MailMessage mewakili sebuah pesan email. Instance kelas MailMessage digunakan untuk membangun pesan email yang dikirim ke server SMTP untuk pengiriman menggunakan kelas SmtpClient. Badan email dapat ditentukan menggunakan kelas MailMessage. Email dapat memiliki beberapa badan. Ada dua tipe badan email dalam kelas MailMessage:

  • Body HTML
  • Body teks

Selain HtmlBody dan TextBody, Aspose.Email memiliki dua properti hanya-baca lain yang terkait dengan badan email:

  • IsBodyText: memberi tahu pengguna apakah badan pesan berupa teks.
  • IsBodyHtml: memberi tahu pengguna apakah badan pesan berupa HTML atau teks biasa.

Artikel ini menunjukkan cara mendefinisikan teks biasa atau teks body HTML, mengatur teks alternatif, dan mengkodekan body email.

Mengatur Badan HTML

HtmlBody digunakan untuk menentukan konten HTML dari badan pesan. HtmlBody harus berada di antara tag . Potongan kode berikut menunjukkan cara mengatur badan HTML.

Mengatur Teks Alternatif

Gunakan kelas AlternateView untuk menentukan salinan pesan email dalam format berbeda. Misalnya, jika Anda mengirim pesan dalam format HTML, Anda mungkin juga ingin menyediakan versi teks biasa jika beberapa penerima menggunakan pembaca email yang tidak dapat menampilkan konten HTML. Kelas ini memiliki dua properti, LinkedResources dan BaseUri, yang digunakan untuk menyelesaikan URL dalam konten email.

  • LinkedResources adalah kumpulan objek LinkedResources. Saat dirender, URL dalam konten email pertama‑tama dicocokkan dengan URL di Content Link tiap objek LinkedResources dalam koleksi LinkedResources, dan diselesaikan.
  • BaseUri digunakan oleh pembaca email untuk menyelesaikan URL relatif dalam badan, dan juga untuk menyelesaikan URL Content Link relatif, dalam koleksi LinkedResources.

Potongan kode berikut menunjukkan cara mengatur teks alternatif.

Fitur MailMessage

The MailMessage class mewakili konten pesan email. Instansi dari MailMessage class digunakan untuk membangun pesan email yang dikirim ke server SMTP untuk pengiriman menggunakan SmtpClient class. Artikel ini menunjukkan cara menggunakan MailMessage fitur utilitas class untuk mengontrol fitur email berikut:

  • Tanggal dan waktu - Melalui MailMessage Properti class Date memungkinkan kita mendapatkan atau mengatur tanggal dan waktu email.
  • Prioritas pesan - MailPriority kelas menentukan tingkat prioritas untuk mengirim pesan email. Bisa rendah, normal, atau tinggi. Prioritas memengaruhi kecepatan transmisi dan pengiriman.
  • Sensitivitas pesan - MailSensitivity kelas menentukan lima tingkat sensitivitas.
  • Notifikasi pengiriman - Notifikasi pengiriman memberi tahu pengirim bahwa email yang mereka kirim telah sampai ke kotak masuk penerima.

Secara default, tanggal adalah tanggal sebenarnya pesan dikirim, dan waktu adalah waktu pengirimannya, sebagaimana ditampilkan oleh Microsoft Outlook. Namun, waktu pengiriman email yang sebenarnya ditambahkan oleh server SMTP sendiri di header email. Misalnya, di bawah ini adalah header email umum, di mana Date mengatur bidang Date.

Potongan kode di bawah ini menggambarkan cara setiap fitur yang dibahas di atas dapat digunakan.

Meminta Tanda Terima Baca

Contoh kode pemrograman di bawah ini menunjukkan cara Anda dapat meminta tanda terima baca. The MailMessage kelas DeliveryNotificationOptions Properti enumerasi menggambarkan opsi notifikasi pengiriman untuk sebuah email. Untuk meminta tanda terima baca setelah mengirim email, ikuti langkah-langkah berikut:

  1. Buat sebuah instansi dari MailMessage kelas.
  2. Tentukan pengirim, penerima, dan body HTML untuk email dalam MailMessage instance.
  3. Tentukan DeliveryNotificationOptions di lain MailMessage instance.
  4. Buat sebuah instansi dari SmtpClient kelas dan kirim email menggunakan metode Send.

Permintaan tanda terima baca tidak selalu dipenuhi karena:

  • Klien email mungkin tidak mengimplementasikan fungsi tersebut.
  • Pengguna akhir mungkin menonaktifkan fungsi tersebut.
  • Pengguna akhir dapat memilih untuk tidak mengirimnya.

Potongan kode berikut menunjukkan cara meminta tanda terima baca.

Set Header Email

Header email mewakili standar Internet dan RFC mendefinisikan field header yang termasuk dalam pesan email Internet. Header email dapat ditentukan menggunakan kelas MailMessage. Tipe header umum didefinisikan dalam kelas HeaderType. Ini adalah kelas sealed yang berfungsi seperti enumerasi normal.

Biasanya header email berisi field-field berikut:

  • To: Alamat penerima dapat ditentukan dalam bidang To. Penerima dalam bidang To adalah audiens utama pesan. Bisa ada lebih dari satu alamat penerima.
  • From: Field ini menampilkan alamat email pengirim pesan.
  • Cc: Memungkinkan pengguna mengirim pesan sebagai "Carbon Copy" atau "Courtesy Copy". Artinya, penerima tidak diharapkan membalas atau bertindak. Biasanya, personel pengawas diberi tahu dengan CC.
  • Bcc: Singkatan dari Blind Carbon Copy, merujuk pada praktik mengirim pesan ke banyak penerima sedemikian rupa sehingga apa yang mereka terima tidak berisi daftar lengkap penerima. Ini dimaksudkan untuk notifikasi tersembunyi.
  • ReplyTo: Field header ini dimaksudkan untuk menunjukkan ke mana pengirim menginginkan balasan dikirim.
  • Subject: Judul, heading, subjek. Sering digunakan sebagai indikator utas untuk pesan yang membalas atau mengomentari pesan lain.
  • Date: Header ini menentukan tanggal (dan waktu). Biasanya ini adalah tanggal ketika pesan dibuat dan dikirim.
  • XMailer: Informasi tentang perangkat lunak klien pengirim. Contoh: X-Mailer: Aspose.Email XMailer digunakan oleh klien email. Klien email yang berbeda akan memiliki nilai XMailer yang berbeda. Nilai XMailer pada MS Outlook adalah Microsoft Office Outlook, Build 11.0.5510. Nilai ini diabaikan oleh penerima email atau pembaca email.

Biasanya, header email terlihat seperti ini:


 Reply-To: reply@reply.com

From: sender@sender.com

To: guangzhou@guangzhoo.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

Untuk menyesuaikan header email, ikuti langkah-langkah berikut:

  • Buat sebuah instansi dari MailMessage kelas.
  • Tentukan To, From, CC, Bcc, ReplyTo, Subject, Date & XMailer menggunakan instance dari MailMessage.
  • Buat sebuah instansi dari MimeHeader kelas dan tentukan header rahasia.
  • Tambahkan header rahasia ke MailMessage instance.

Potongan kode berikut menunjukkan cara mengatur header email.

Potongan kode di atas menghasilkan header email dalam format berikut. Ini dapat dilihat dengan membuka file hasil "MsgHeaders.msg" di Microsoft Outlook dan kemudian melihat Properties.


 Reply-To: reply@reply.com

From: sender@sender.com

To: receiver1@receiver.com

CC: receiver2@receiver.com

BCC: receiver3@receiver.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

Sisipkan Header pada Lokasi Spesifik

The Tambah metode dari HeadersCollection kelas menyisipkan header di akhir koleksi. Namun, kadang diperlukan menyisipkan header pada lokasi tertentu. Dalam kasus tersebut, Tambah metode tidak akan membantu. Untuk mencapainya, gunakan Insert metode dari HeadersCollection. Jika koleksi berisi header dengan nama yang sama, header ini akan disisipkan sebelum header lain dengan nama yang sama. Potongan kode berikut menunjukkan cara menyisipkan header pada lokasi tertentu.

Menambahkan Header Kustom ke Email

Contoh kode di bawah menunjukkan cara menentukan header khusus dalam pesan email. Header email dapat ditentukan menggunakan MailMessage kelas. Untuk menentukan header khusus dalam pesan email, ikuti langkah-langkah berikut:

  1. Buat sebuah instansi dari MailMessage kelas.
  2. Tentukan nilai to, from, dan subject menggunakan instance MailMessage.
  3. Tambahkan header rahasia ke dalam MailMessage instance.
  4. Buat sebuah instance dari kelas SmtpClient dan kirim email menggunakan metode Send.

Cuplikan kode berikut menunjukkan cara menambahkan header kustom ke email.

Mengekstrak Konten Pesan dari Email