Ambil dan Daftar Email dari Server IMAP
Mengambil dan Mendaftar Pesan
Cara Mendapatkan Informasi Identifikasi untuk Pesan dalam Kotak Surat
Saat mengambil dan memproses pesan email, Anda dapat memperoleh informasi identifikasi detail, seperti nomor urut dan ID unik, dengan menggunakan fitur berikut yang disediakan oleh versi terbaru Aspose.Email untuk .NET:
Aspose.Email.ImapMessageInfo kelas: Mewakili informasi identifikasi tentang pesan dalam kotak surat IMAP.
ImapMessageInfo.SequenceNumber properti: Mengambil nomor urut pesan.
ImapMessageInfo.UniqueId properti: Mengambil pengidentifikasi unik dari pesan.
Aspose.Email.MailMessage.ItemId properti: Mewakili informasi identifikasi tambahan tentang pesan di dalam kotak surat.
Cuplikan kode berikut memperlihatkan cara mendapatkan informasi identifikasi untuk pesan dalam kotak surat IMAP:
- Buat sebuah instansi dari ImapClient kelas dengan menyediakan parameter yang diperlukan seperti host server IMAP, port, alamat email, kata sandi, dan opsi keamanan.
- Gunakan ListMessages metode untuk mengambil daftar pesan dari folder "INBOX". Batasi daftar hingga lima pesan pertama menggunakan metode Take(5).
- Ekstrak nomor urut dari pesan yang terdaftar dengan menggunakan SequenceNumber properti setiap pesan.
- Gunakan FetchMessages metode untuk mengambil detail lengkap dari pesan di server, menggunakan nomor urut yang diperoleh pada langkah sebelumnya.
- Loop melalui pesan yang diambil dan untuk setiap pesan, ambil serta tampilkan informasi berikut:
- Nomor urut pesan.
- Properti ItemId.SequenceNumber.
- Subjek pesan.
using (var client = new ImapClient(imapHost, port, emailAddress, password, securityOption))
{
// List the first 5 messages from the inbox
var msgs = client.ListMessages("INBOX").Take(5);
// Get sequence numbers of the messages
var seqIds = msgs.Select(t => t.SequenceNumber);
// Fetch messages based on sequence numbers
var msgsViaFetch = client.FetchMessages(seqIds);
for (var i = 0; i < 5; i++)
{
var thisMsg = msgsViaFetch[i];
Console.WriteLine($"Message ID: {seqIds.ElementAt(i)} SequenceNumber: {thisMsg.ItemId.SequenceNumber} Subject: {thisMsg.Subject}");
}
}
Daftar ID Pesan MIME dari Server
ImapMessageInfo menyediakan MIME MessageId untuk identifikasi pesan tanpa mengekstrak seluruh pesan. Potongan kode berikut menunjukkan cara mencantumkan MIME messageId.
Daftar Pesan dari Server
Aspose.Email menyediakan varian overload 2-anggota dari ListMessages() untuk mengambil sejumlah pesan tertentu berdasarkan kueri. Cuplikan kode berikut menunjukkan cara mendaftar Pesan.
Daftar Pesan secara Rekursif
Protokol IMAP mendukung pencantuman pesan secara rekursif dari folder kotak surat. Ini membantu mencantumkan pesan dari subfolder suatu folder juga. Potongan kode berikut menunjukkan cara mencantumkan pesan secara rekursif.
Daftar Pesan dengan MultiConnection
ImapClient menyediakan sebuah UseMultiConnection properti yang dapat digunakan untuk membuat beberapa koneksi untuk operasi berat. Anda juga dapat mengatur jumlah koneksi yang akan digunakan selama mode multikoneksi dengan menggunakan ImapClient.ConnectionsQuantity. Potongan kode berikut mendemonstrasikan penggunaan mode multikoneksi untuk mencantumkan pesan dan membandingkan kinerjanya dengan mode koneksi tunggal.
Daftar Pesan dengan Dukungan Paging
Dalam skenario, di mana server email berisi sejumlah besar pesan di kotak surat, sering diinginkan untuk menampilkan atau mengambil pesan dengan dukungan pagination. API Aspose.Email ImapClient memungkinkan Anda mengambil pesan dari server dengan dukungan paging.
Daftar Lampiran Pesan
Untuk mendapatkan informasi tentang lampiran seperti nama, ukuran tanpa mengambil data lampiran, coba API berikut:
- Aspose.Email.Clients.Imap.ImapAttachmentInfo - Mewakili informasi lampiran.
- Aspose.Email.Clients.Imap.ImapAttachmentInfoCollection - Mewakili kumpulan dari ImapAttachmentInfo kelas.
- Aspose.Email.Clients.Imap.ListAttachments(int sequenceNumber) - Mendapatkan informasi untuk setiap lampiran dalam sebuah pesan.
Contoh kode dengan langkah-langkah di bawah ini akan menunjukkan cara menggunakan API:
- Panggil ListMessages() metode pada objek imapClient. Metode ini akan mengembalikan ImapMessageInfoCollection yang berisi informasi tentang pesan-pesan di kotak surat.
- Iterasikan setiap pesan dalam messageInfoCollection menggunakan perulangan foreach.
- Panggil ListAttachments() metode pada objek imapClient, dengan memberikan properti SequenceNumber dari objek pesan sebagai parameter. Metode ini akan mengembalikan ImapAttachmentInfoCollection yang berisi informasi tentang lampiran dalam pesan.
- Iterasikan setiap lampiran dalam attachmentInfoCollection menggunakan perulangan foreach.
- Di dalam loop internal, Anda dapat mengakses informasi tentang setiap lampiran menggunakan properti objek attachmentInfo.
var messageInfoCollection = imapClient.ListMessages();
foreach (var message in messageInfoCollection)
{
var attachmentInfoCollection = imapClient.ListAttachments(message.SequenceNumber);
foreach (var attachmentInfo in attachmentInfoCollection)
{
Console.WriteLine("Attachment: {0} (size: {1})", attachmentInfo.Name, attachmentInfo.Size);
}
}
Mengambil dan Menyimpan Pesan
Ambil Pesan dari Server
The ImapClient kelas dapat mengambil pesan dari server IMAP dan menyimpan pesan dalam format EML ke disk lokal. Langkah-langkah berikut diperlukan untuk menyimpan pesan ke disk:
- Buat sebuah instansi dari ImapClient kelas.
- Tentukan hostname, port, username, dan password di ImapClient constructor.
- Pilih folder menggunakan SelectFolder() metode.
- Panggil ListMessages metode untuk memperoleh ImapMessageInfoCollection objek.
- Iterasi melalui ImapMessageInfoCollection koleksi, panggil SaveMessage() metode dan berikan jalur output serta nama file.
Potongan kode berikut menunjukkan cara mengambil pesan email dari server dan menyimpannya.
Ambil Pesan dalam Urutan Menurun
Aspose.Email menyediakan ImapClient.ListMessagesByPage metode yang menampilkan pesan dengan dukungan paging. Beberapa overload dari ImapClient.ListMessagesByPage menerima PageSettings sebagai parameter. PageSettings menyediakan sebuah AscendingSorting properti yang, ketika disetel ke false, mengembalikan email dalam urutan menurun.
Contoh kode berikut menunjukkan penggunaan AscendingSorting properti dari PageSettings kelas untuk mengubah urutan email.
Simpan Pesan dalam Format MSG
Untuk menyimpan email dalam format MSG, ImapClient.FetchMessage() metode perlu dipanggil. Ini mengembalikan pesan dalam sebuah instance dari MailMessage kelas. The MailMessage.Save() metode kemudian dapat dipanggil untuk menyimpan pesan ke MSG. Potongan kode berikut menunjukkan cara menyimpan pesan dalam Format MSG.
Kelompokkan Pesan yang Diambil
ImapClient menyediakan sebuah FetchMessages metode yang menerima iterable dari Nomor Urut atau ID Unik dan mengembalikan daftar MailMessage. Potongan kode berikut menunjukkan penggunaan the FetchMessages metode untuk mengambil pesan berdasarkan Nomor Urut dan ID Unik.
Ambil Folder dan Baca Pesan Secara Rekursif
Dalam artikel ini, sebagian besar ImapClient fitur-fitur ini digunakan untuk membuat aplikasi yang menampilkan semua folder dan subfolder secara rekursif dari server IMAP. Ini juga menyimpan pesan di setiap folder dan subfolder dalam format MSG di disk lokal. Di disk, folder dan pesan dibuat serta disimpan dalam struktur hierarkis yang sama seperti di server IMAP. Potongan kode berikut menunjukkan cara mendapatkan pesan dan informasi subfolder secara rekursif.
Menangani Informasi Pesan Khusus
Ambil Parameter Tambahan sebagai Informasi Ringkas
Dapatkan Informasi Header List-Unsubscribe
Header List-Unsubscribe berisi URL untuk berhenti berlangganan dari daftar email, misalnya iklan, buletin, dll. Untuk mendapatkan header List-Unsubscribe, gunakan ListUnsubscribe properti dari ImapMessageInfo kelas. Contoh berikut menunjukkan penggunaan ListUnsubscribe properti untuk mendapatkan header List-Unsubscribe.