Documentation – การทำงานกับ IMAP Client

Net: เชื่อมต่อกับเซิร์ฟเวอร์ IMAP

Mon, 01 Jan 0001 00:00:00 +0000

แสดงรายการส่วนขยายของเซิร์ฟเวอร์ IMAP

ของ Aspose.Email ImapClient ทำให้คุณสามารถดึงส่วนขยายของเซิร์ฟเวอร์ที่เซิร์ฟเวอร์รองรับ เช่น IDLE, UNSELECT, QUOTA ฯลฯ ซึ่งช่วยระบุว่ามีส่วนขยายดังกล่าวหรือไม่ก่อนใช้ไคลเอนต์สำหรับฟังก์ชันนั้น The GetCapabilities() เมธอดคืนค่าประเภทส่วนขยายที่รองรับในรูปแบบอาร์เรย์ของสตริง ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเรียกคืนส่วนขยาย.

การเชื่อมต่อ IMAP มาตรฐาน

นี้ ImapClient คลาสนี้อนุญาตให้แอปพลิเคชันจัดการกล่องเมล IMAP ด้วยโปรโตคอล IMAP. ImapClient คลาสนี้ใช้เชื่อมต่อกับเซิร์ฟเวอร์เมล IMAP และจัดการอีเมลในโฟลเดอร์ IMAP เพื่อเชื่อมต่อกับเซิร์ฟเวอร์ IMAP

สร้างอินสแตนซ์ของ ImapClient คลาส.
ระบุ hostname, username, และ password ใน คอนสตรัคเตอร์ ImapClient.

หมายเหตุ ข้อจำกัดรหัสผ่านต้องตรงกับความต้องการของเซิร์ฟเวอร์ ลูกค้าอีเมลไม่ได้เพิ่มข้อจำกัดรหัสผ่าน

เมื่อ ImapClient เมื่ออินสแตนซ์เริ่มต้น การเรียกใช้งานใด ๆ ต่อไปโดยใช้อินสแตนซ์นี้จะเชื่อมต่อกับเซิร์ฟเวอร์ โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับเซิร์ฟเวอร์ IMAP โดยใช้ขั้นตอนข้างต้น.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

การเชื่อมต่อ IMAP ที่เปิดใช้งาน SSL

การเชื่อมต่อกับเซิร์ฟเวอร์ IMAP อธิบายวิธีเชื่อมต่อกับเซิร์ฟเวอร์ IMAP ในสี่ขั้นตอนง่าย ๆ:

สร้างอินสแตนซ์ของ ImapClient คลาส.
ระบุ hostname, username, และ password.
ระบุพอร์ต.
ระบุตัวเลือกความปลอดภัย.

กระบวนการเชื่อมต่อกับเซิร์ฟเวอร์ IMAP ที่เปิดใช้งาน SSL จะคล้ายกันแต่ต้องตั้งค่าอีกหลายคุณสมบัติ:

ตั้งค่า SecurityOptions ไปยัง SSLImplicit.

โค้ดตัวอย่างต่อไปนี้แสดงวิธี

ตั้งค่าชื่อผู้ใช้, รหัสผ่าน, และพอร์ต.
ตั้งค่าตัวเลือกความปลอดภัย

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create an instance of the ImapClient class
ImapClient client = new ImapClient("imap.domain.com", 993, "user@domain.com", "pwd");
            
// Set the security mode to implicit
client.SecurityOptions = SecurityOptions.SSLImplicit;

การตั้งค่าการเชื่อมต่อพร็อกซี

เชื่อมต่อกับเซิร์ฟเวอร์ผ่าน Proxy

เซิร์ฟเวอร์พร็อกซีมักใช้ในการสื่อสารกับภายนอก ในกรณีดังกล่าว ไคลเอนต์อีเมลไม่สามารถสื่อสารผ่านอินเทอร์เน็ตได้หากไม่ได้ระบุที่อยู่พร็อกซี Aspose.Email ให้การสนับสนุนเวอร์ชัน 4, 4a และ 5 ของโปรโตคอล SOCKS Proxy บทความนี้ให้ตัวอย่างการเข้าถึงกล่องจดหมายโดยใช้เซิร์ฟเวอร์เมลพร็อกซี เพื่อเข้าถึงกล่องจดหมายผ่านเซิร์ฟเวอร์พร็อกซี:

Initialize SocksProxy ด้วยข้อมูลที่ต้องการ ได้แก่ ที่อยู่พร็อกซี, พอร์ต, และเวอร์ชันของ SOCKS
Initialize ImapClient ด้วยที่อยู่โฮสต์, ชื่อผู้ใช้, รหัสผ่าน และการตั้งค่าอื่น ๆ
ตั้งค่าของไคลเอนต์ SocksProxy คุณสมบัติของไคลเอนต์ไปยัง SocksProxy วัตถุที่สร้างขึ้นด้านบน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีดึงกล่องจดหมายผ่านเซิร์ฟเวอร์พร็อกซี

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Connect and log in to IMAP and set SecurityOptions
ImapClient client = new ImapClient("imap.domain.com", "username", "password");
client.SecurityOptions = SecurityOptions.Auto;
            
string proxyAddress = "192.168.203.142"; // proxy address
int proxyPort = 1080; // proxy port
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);

// Set the proxy
client.Proxy = proxy;
           
try
{
    client.SelectFolder("Inbox");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

เชื่อมต่อกับเซิร์ฟเวอร์ผ่าน HTTP Proxy

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
HttpProxy proxy = new HttpProxy("18.222.124.59", 8080);
using (ImapClient client = new ImapClient("imap.domain.com", "username", "password"))
{
    client.Proxy = proxy;
    client.SelectFolder("Inbox");
}

การเชื่อมต่อแบบอ่านอย่างเดียว

นี้ ImapClient คลาสให้ ReadOnly คุณสมบัติที่เมื่อกำหนดเป็น true จะหมายถึงไม่ให้ทำการเปลี่ยนแปลงใด ๆ กับภาวะถาวรของกล่องจดหมาย ตัวอย่างโค้ดต่อไปนี้แสดงการใช้ ImapClient.ReadOnly คุณสมบัติ จะรับจำนวนข้อความที่ยังไม่ได้อ่าน แล้วดึงข้อความหนึ่งข้อความและรับจำนวนข้อความที่ยังไม่ได้อ่านอีกครั้งในโหมดอ่านอย่างเดียว จำนวนข้อความที่ยังไม่ได้อ่านยังคงเท่าเดิมแสดงว่าภาวะถาวรของกล่องจดหมายไม่ได้เปลี่ยนแปลง

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
ImapClient imapClient = new ImapClient();
imapClient.Host = "<HOST>";
imapClient.Port = 993;
imapClient.Username = "<USERNAME>";
imapClient.Password = "<PASSWORD>";
imapClient.SupportedEncryption = EncryptionProtocols.Tls;
imapClient.SecurityOptions = SecurityOptions.SSLImplicit;

ImapQueryBuilder imapQueryBuilder = new ImapQueryBuilder();
imapQueryBuilder.HasNoFlags(ImapMessageFlags.IsRead); /* get unread messages. */
MailQuery query = imapQueryBuilder.GetQuery();

imapClient.ReadOnly = true;
imapClient.SelectFolder("Inbox");
ImapMessageInfoCollection messageInfoCol = imapClient.ListMessages(query);
Console.WriteLine("Initial Unread Count: " + messageInfoCol.Count());
if (messageInfoCol.Count() > 0)
{
    imapClient.FetchMessage(messageInfoCol[0].SequenceNumber);

    messageInfoCol = imapClient.ListMessages(query);
    // This count will be equal to the initial count
    Console.WriteLine("Updated Unread Count: " + messageInfoCol.Count());
}
else
{
    Console.WriteLine("No unread messages found");
}

การตั้งค่าการตรวจสอบ CRAM-MD5

สำหรับการตรวจสอบสิทธิ์ที่ปลอดภัยและการเข้าถึงเซิร์ฟเวอร์อีเมล Aspose.Email สำหรับ .NET มีวิธีการตรวจสอบ CRAM-MD5 ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีทำงานกับ ImapClient:

imapClient.AllowedAuthentication = ImapKnownAuthenticationType.CramMD5;

การตั้งค่าเวลาหมดสำหรับการดำเนินการ IMAP

การดำเนินการเมลแต่ละครั้งใช้เวลาตามปัจจัยหลายอย่าง (ความล่าช้าเครือข่าย, ขนาดข้อมูล, ประสิทธิภาพเซิร์ฟเวอร์ เป็นต้น) คุณสามารถตั้งค่าเวลาจำกัดสำหรับการดำเนินการเมลทั้งหมด ตัวอย่างโค้ดด้านล่างแสดงวิธีทำโดยใช้ เวลาจำกัด คุณสมบัติ หมายเหตุ: ไม่ควรกำหนดค่าขนาดใหญ่เพื่อหลีกเลี่ยงการรอคอยนานในแอปพลิเคชันของคุณ

กำหนดค่าเวลาหมดอายุของการดำเนินการ

using (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.Timeout = 60000; // 60 seconds

    // some code...
}

จำกัดเวลา Greeting Timeout

ไคลเอนต์ IMAP อาจใช้โหมดอัตโนมัติในการสร้างการเชื่อมต่อ ในโหมดนี้ ไคลเอนต์ IMAP จะลองทุกพารามิเตอร์การเชื่อมต่อที่เป็นไปได้จนกว่าจะเชื่อมต่อสำเร็จ เซิร์ฟเวอร์ IMAP เมื่อการเชื่อมต่อถูกต้องจะส่งสตริงต้อนรับไปยังไคลเอนต์ เซิร์ฟเวอร์อาจเริ่มต้นการเชื่อมต่อ SSL/TLS แบบโดยอัตโนมัติหรือแบบชัดเจน (START TLS) หากโหมดการเชื่อมต่อไม่ตรงกัน (เช่น เซิร์ฟเวอร์รอการเชื่อมต่อ SSL แบบโดยอัตโนมัติแต่ไคลเอนต์พยายามเชื่อมต่อแบบไม่ปลอดภัยหรือแบบ SSL ชัดเจน) เซิร์ฟเวอร์จะไม่ส่งสตริงต้อนรับและผู้ใช้จะต้องรอเป็นเวลานานจนถึงการหมดเวลาเพื่อรับสตริงต้อนรับ และไคลเอนต์จะไปยังตัวเลือกการเชื่อมต่อถัดไป เพื่อหลีกเลี่ยงปัญหานี้ ได้มีการแนะนำคุณสมบัติ GreetingTimeout คุณสมบัตินี้ช่วยให้คุณตั้งค่าเวลาหมดสำหรับสตริงต้อนรับ และลดระยะเวลาในการสร้างการเชื่อมต่ออัตโนมัติ

using (ImapClient client = new ImapClient("localhost", 993, "username", "password"))
{
    client.GreetingTimeout = 4000;
    client.SelectFolder(ImapFolderInfo.InBox);
}

การใช้โปรโตคอลการเข้ารหัสกับ IMAP

Aspose.Email รองรับโปรโตคอลการเข้ารหัส SSL (ล่าช้า) และ TLS เพื่อให้ความปลอดภัยในการสื่อสาร. คุณสามารถเปิดการเข้ารหัสเชิงคริปโตเพื่อปกป้องการแลกเปลี่ยนข้อมูลระหว่างแอปพลิเคชันของคุณและเซิร์ฟเวอร์เมล.

หมายเหตุ: คุณควรตั้งค่าเฉพาะเวอร์ชันของโปรโตคอลที่รองรับโดย .NET Framework. หากเวอร์ชันบางส่วนของโปรโตคอลการเข้ารหัสไม่รองรับโดย .NET Framework ที่คุณใช้, จะถูกละเว้นและข้ามไป. ในกรณีนี้, จะไม่มีข้อยกเว้นถูกสร้าง. กรุณาใช้ SetSupportedEncryptionUnsafe เมธอดหากคุณต้องการตั้งค่าโปรโตคอลโดยไม่มีการตรวจสอบความเข้ากันได้.

ตัวอย่างโค้ดด้านล่างจะแสดงวิธีตั้งค่า TLS 1.3 สำหรับ ImapClient อินสแตนซ์ของคลาส.

using (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.SupportedEncryption = EncryptionProtocols.Tls13;

    // some code...
}

ในกรณีที่โปรโตคอลการเข้ารหัสที่ระบุไม่รองรับในเวอร์ชันปัจจุบันของ .NET Framework, ความแตกต่างของพฤติกรรมระหว่าง SetSupportedEncryptionUnsafe เมธอดและ SupportedEncryption คุณสมบัติคือดังต่อไปนี้:

If SupportedEncryption คุณสมบัติกำลังใช้, ไคลเอนต์อีเมลจะลดระดับโปรโตคอลการเข้ารหัสลงเป็นระดับที่รองรับ.
If SetSupportedEncryptionUnsafe เมธอดถูกใช้, ไคลเอนต์อีเมลจะโยนข้อยกเว้น.

การใช้คำสั่ง IMAP IDLE

API ของ Aspose.Email ImapClient ให้ความสามารถในการเปิดการเชื่อมต่อไปยังเซิร์ฟเวอร์และรอการมาถึงของข้อความอีเมล ซึ่งช่วยหลีกเลี่ยงการสอบถามเซิร์ฟเวอร์ซ้ำ ๆ สำหรับอีเมลขาเข้า ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ไลบรารี Aspose.Email เพื่อตรวจสอบกล่องจดหมาย IMAP สำหรับข้อความใหม่และข้อความที่ถูกลบ แล้วทำการกระทำเฉพาะตามเหตุการณ์เหล่านั้น:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Connect and log in to IMAP 
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

ManualResetEvent manualResetEvent = new ManualResetEvent(false);
ImapMonitoringEventArgs eventArgs = null;
client.StartMonitoring(delegate(object sender, ImapMonitoringEventArgs e)
{
    eventArgs = e;
    manualResetEvent.Set();
});
Thread.Sleep(2000);
SmtpClient smtpClient = new SmtpClient("exchange.aspose.com", "username", "password");
smtpClient.Send(new MailMessage("from@aspose.com", "to@aspose.com", "EMAILNET-34875 - " + Guid.NewGuid(), "EMAILNET-34875 Support for IMAP idle command"));
manualResetEvent.WaitOne(10000);
manualResetEvent.Reset();
Console.WriteLine(eventArgs.NewMessages.Length);
Console.WriteLine(eventArgs.DeletedMessages.Length);
client.StopMonitoring("Inbox");
smtpClient.Send(new MailMessage("from@aspose.com", "to@aspose.com", "EMAILNET-34875 - " + Guid.NewGuid(), "EMAILNET-34875 Support for IMAP idle command"));
manualResetEvent.WaitOne(5000);

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตั้งค่าการเฝ้าติดตาม แบบอะซิงโครนัส สำหรับข้อความอีเมลใหม่:

var client = = new ImapClient("imap.domain.com", "username", "password");

//anySuccess is a flag to prevent infinite Client.ResumeMonitoring calls
var anySuccess = false;
await client.StartMonitoringAsync(OnNewMessagesCallback, OnErrorCallback);

void OnErrorCallback(object eventSender, ImapMonitoringErrorEventArgs errorEventArguments)
{
    //The exception can be handled here
    Logger.Debug.Write(
        $"An error occured while folder monitoring: {errorEventArguments.FolderName}",
        errorEventArguments.Error);
    //IMAP folder monitoring is stopped on any error. Here is an example
    //of resuming after that.
    if (!anySuccess) return;
    anySuccess = false;
    //Make sure you use ResumeMonitoring instead of StartMonitoring here
    //to prevent missing any emails between the error handling and resuming.
    client.ResumeMonitoring(OnNewMessagesCallback, OnErrorCallback,
        errorEventArguments.MonitoringState);
}

void OnNewMessagesCallback(object sender, ImapMonitoringEventArgs successEventArgs)
{
    anySuccess = true;
    //Use successEventArgs.NewMessages to handle new messages
    //Use successEventArgs.DeletedMessages to handle deleted messages
}

รองรับส่วนขยายของ IMAP

Aspose.Email API ให้การสนับสนุนส่วนขยายของ IMAP ส่วนขยาย IMAP ต่อไปนี้ได้รับการสนับสนุนโดย API ในปัจจุบัน อย่างไรก็ตาม ส่วนขยายเหล่านี้ไม่ได้รับการสนับสนุนจากเซิร์ฟเวอร์ทั้งหมด

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password"))
{
    // Set SecurityOptions
    client.SecurityOptions = SecurityOptions.Auto;
    Console.WriteLine(client.IdSupported.ToString());

    ImapIdentificationInfo serverIdentificationInfo1 = client.IntroduceClient();
    ImapIdentificationInfo serverIdentificationInfo2 = client.IntroduceClient(ImapIdentificationInfo.DefaultValue);

    // Display ImapIdentificationInfo properties
    Console.WriteLine(serverIdentificationInfo1.ToString(), serverIdentificationInfo2);
    Console.WriteLine(serverIdentificationInfo1.Name);
    Console.WriteLine(serverIdentificationInfo1.Vendor);
    Console.WriteLine(serverIdentificationInfo1.SupportUrl);
    Console.WriteLine(serverIdentificationInfo1.Version);
}

คำสั่งรายการขยาย IMAP4

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้คำสั่งรายการขยายของ IMAP4

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password"))
{
    ImapFolderInfoCollection folderInfoCol = client.ListFolders("*");
    Console.WriteLine("Extended List Supported: " + client.ExtendedListSupported);
    foreach (ImapFolderInfo folderInfo in folderInfoCol)
    {
        switch (folderInfo.Name)
        {
            case "[Gmail]/All Mail":
                Console.WriteLine("Has Children: " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Bin":
                Console.WriteLine("Bin has children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Drafts":
                Console.WriteLine("Drafts has children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Important":
                Console.WriteLine("Important has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Sent Mail":
                Console.WriteLine("Sent Mail has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Spam":
                Console.WriteLine("Spam has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Starred":
                Console.WriteLine("Starred has Children? " + folderInfo.HasChildren);
                break;
        }
    }
}

Net: การจัดการข้อความบนเซิร์ฟเวอร์ IMAP

Mon, 01 Jan 0001 00:00:00 +0000

การดึงและแสดงรายการข้อความ

วิธีรับข้อมูลการระบุของข้อความในกล่องจดหมาย

เมื่อดึงและประมวลผลข้อความอีเมล คุณสามารถรับข้อมูลการระบุอย่างละเอียด เช่น หมายเลขลำดับและ ID ที่ไม่ซ้ำได้โดยใช้คุณลักษณะต่อไปนี้ที่ให้โดยเวอร์ชันล่าสุดของ Aspose.Email สำหรับ .NET:

Aspose.Email.ImapMessageInfo คลาส: แสดงข้อมูลการระบุของข้อความในกล่องจดหมาย IMAP.

ImapMessageInfo.SequenceNumber คุณสมบัติ: ดึงหมายเลขลำดับของข้อความ

ImapMessageInfo.UniqueId คุณสมบัติ: ดึงตัวระบุที่ไม่ซ้ำของข้อความ

Aspose.Email.MailMessage.ItemId คุณสมบัติ: แสดงข้อมูลการระบุเพิ่มเติมของข้อความภายในกล่องจดหมาย

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรับข้อมูลการระบุข้อความในกล่องจดหมาย IMAP:

สร้างอินสแตนซ์ของ ImapClient คลาสโดยให้พารามิเตอร์ที่จำเป็นเช่น โฮสต์เซิร์ฟเวอร์ IMAP, พอร์ต, ที่อยู่อีเมล, รหัสผ่าน, และตัวเลือกความปลอดภัย
ใช้ ListMessages วิธีการดึงรายการข้อความจากโฟลเดอร์ "INBOX" จำกัดรายการที่ 5 ข้อความแรกด้วยเมธอด Take(5)
แยกหมายเลขลำดับของข้อความที่แสดงโดยใช้ SequenceNumber คุณสมบัติของแต่ละข้อความ.
ใช้ FetchMessages วิธีการดึงรายละเอียดทั้งหมดของข้อความจากเซิร์ฟเวอร์โดยใช้หมายเลขลำดับที่ได้จากขั้นตอนก่อนหน้า
วนลูปผ่านข้อความที่ดึงมาและสำหรับแต่ละข้อความ ให้ดึงและแสดงข้อมูลต่อไปนี้:

หมายเลขลำดับของข้อความ.
คุณสมบัติ ItemId.SequenceNumber
หัวเรื่องของข้อความ.

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}");
    }
}

แสดงรายการ ID ของข้อความ MIME จากเซิร์ฟเวอร์

ImapMessageInfo ให้บริการ MIME MessageId สำหรับการระบุข้อความโดยไม่ต้องดึงข้อความเต็ม โค้ดตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการ MIME messageId

แสดงรายการข้อความจากเซิร์ฟเวอร์

Aspose.Email มีรูปแบบ overload 2 สมาชิกของ ListMessages() เพื่อดึงข้อความจำนวนที่ระบุตามคิวรี ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายการข้อความ.

แสดงรายการข้อความแบบเรียกซ้ำ

โปรโตคอล IMAP รองรับการแสดงรายการข้อความแบบเรียงลำดับจากโฟลเดอร์กล่องจดหมาย ซึ่งช่วยให้แสดงข้อความจากโฟลเดอร์ย่อยของโฟลเดอร์ได้ด้วย โค้ดตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการข้อความแบบเรียงลำดับ

แสดงรายการข้อความด้วย MultiConnection

ImapClient ให้การ UseMultiConnection คุณสมบัติที่สามารถใช้สร้างการเชื่อมต่อหลาย ๆ ครั้งสำหรับงานที่มีภาระหนัก. คุณยังสามารถตั้งค่าจำนวนการเชื่อมต่อที่จะใช้ในโหมดหลายการเชื่อมต่อโดยใช้ ImapClient.ConnectionsQuantity. โค้ดตัวอย่างต่อไปนี้แสดงการใช้โหมดหลายการเชื่อมต่อสำหรับการแสดงรายการข้อความและเปรียบเทียบประสิทธิภาพกับโหมดการเชื่อมต่อเดี่ยว

โปรดทราบว่าการใช้โหมดหลายการเชื่อมต่อไม่ได้รับประกันว่าจะเพิ่มประสิทธิภาพ

แสดงรายการข้อความด้วยการสนับสนุนการแบ่งหน้า

ในสถานการณ์ที่เซิร์ฟเวอร์อีเมลมีข้อความจำนวนมากในกล่องจดหมาย บ่อยครั้งที่ต้องการแสดงรายการหรือดึงข้อความโดยมีการสนับสนุนการแบ่งหน้า API ของ Aspose.Email ImapClient ทำให้คุณดึงข้อความจากเซิร์ฟเวอร์พร้อมการสนับสนุนการแบ่งหน้า.

แสดงรายการไฟล์แนบของข้อความ

เพื่อรับข้อมูลเกี่ยวกับไฟล์แนบ เช่น ชื่อ ขนาด โดยไม่ต้องดึงข้อมูลไฟล์แนบ ให้ลองใช้ API ด้านล่าง:

Aspose.Email.Clients.Imap.ImapAttachmentInfo - แสดงข้อมูลไฟล์แนบ
Aspose.Email.Clients.Imap.ImapAttachmentInfoCollection - แสดงชุดของ ImapAttachmentInfo คลาส.
Aspose.Email.Clients.Imap.ListAttachments(int sequenceNumber) - รับข้อมูลของแต่ละไฟล์แนบในข้อความ

ตัวอย่างโค้ดพร้อมขั้นตอนด้านล่างจะแสดงวิธีใช้ API:

เรียกใช้ ListMessages() เมธอดบนอ็อบเจกต์ imapClient เมธอดนี้จะคืนค่า ImapMessageInfoCollection ที่มีข้อมูลเกี่ยวกับข้อความในกล่องจดหมาย
ทำการวนซ้ำแต่ละข้อความใน messageInfoCollection ด้วยลูป foreach
เรียกใช้ ListAttachments() เมธอดบนอ็อบเจกต์ imapClient โดยส่งคุณสมบัติ SequenceNumber ของอ็อบเจกต์ข้อความเป็นพารามิเตอร์ เมธอดนี้จะคืนค่า ImapAttachmentInfoCollection ที่มีข้อมูลเกี่ยวกับไฟล์แนบในข้อความ
ทำการวนซ้ำแต่ละไฟล์แนบใน attachmentInfoCollection ด้วยลูป foreach
ภายในลูปภายใน คุณสามารถเข้าถึงข้อมูลของแต่ละไฟล์แนบโดยใช้คุณสมบัติของอ็อบเจกต์ 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);
    }
}

ดึงและบันทึกข้อความ

ดึงข้อความจากเซิร์ฟเวอร์

นี้ ImapClient คลาสสามารถดึงข้อความจากเซิร์ฟเวอร์ IMAP และบันทึกข้อความในรูปแบบ EML ลงดิสก์ท้องถิ่น ขั้นตอนต่อไปนี้จำเป็นเพื่อนำข้อความบันทึกลงดิสก์:

สร้างอินสแตนซ์ของ ImapClient คลาส.
ระบุชื่อโฮสต์, พอร์ต, ชื่อผู้ใช้, และรหัสผ่านใน ImapClient คอนสตรัคเตอร์.
เลือกโฟลเดอร์โดยใช้ SelectFolder() เมธอด.
เรียกใช้ ListMessages เมธอดเพื่อดึง ImapMessageInfoCollection อ็อบเจ็กต์.
วนซ้ำผ่าน ImapMessageInfoCollection คอลเล็กชัน เรียก SaveMessage() เมธอดและกำหนดเส้นทางเอาต์พุตและชื่อไฟล์.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อความอีเมลจากเซิร์ฟเวอร์และบันทึกลง

ดึงข้อความในลำดับจากมากไปน้อย

Aspose.Email ให้บริการ ImapClient.ListMessagesByPage เมธอดที่แสดงรายการข้อความพร้อมการรองรับการแบ่งหน้า การโอเวอร์โหลดบางส่วนของ ImapClient.ListMessagesByPage รับ PageSettings เป็นพารามิเตอร์. PageSettings ให้การ AscendingSorting คุณสมบัติที่เมื่อกำหนดเป็น false จะคืนค่าอีเมลในลำดับ descending

โค้ดตัวอย่างต่อไปนี้สาธิตการใช้ของ AscendingSorting คุณสมบัติของ PageSettings คลาสเพื่อเปลี่ยนออเดอร์ของอีเมล.

บันทึกข้อความในรูปแบบ MSG

เพื่อบันทึกอีเมลในรูปแบบ MSG, ImapClient.FetchMessage() ต้องเรียกเมธอดนี้ มันจะคืนข้อความในอินสแตนซ์ของ MailMessage คลาส. เมธอด MailMessage.Save() เมธอดนั้นสามารถเรียกเพื่อบันทึกข้อความเป็นไฟล์ MSG ตัวอย่างโค้ดต่อไปนี้แสดงวิธีบันทึกข้อความในรูปแบบ MSG.

จัดกลุ่มข้อความที่ดึงมา

ImapClient ให้การ FetchMessages เมธอดที่รับ iterable ของลำดับหมายเลขหรือ Unique ID และคืนค่าเป็นรายการของ MailMessage. โค้ดสแนปต่อไปนี้แสดงการใช้ FetchMessages เมธอดเพื่อดึงข้อความตามลำดับหมายเลขและ ID ที่ไม่ซ้ำกัน.

ดึงโฟลเดอร์และอ่านข้อความแบบเรียกซ้ำ

ในบทความนี้ ส่วนใหญ่ของ ImapClient ฟีเจอร์เหล่านี้ใช้เพื่อสร้างแอปพลิเคชันที่แสดงรายการโฟลเดอร์และโฟลเดอร์ย่อยทั้งหมดโดยการเรียกซ้ำจากเซิร์ฟเวอร์ IMAP นอกจากนี้ยังบันทึกข้อความในแต่ละโฟลเดอร์และโฟลเดอร์ย่อยในรูปแบบ MSG บนดิสก์ท้องถิ่น บนดิสก์ โฟลเดอร์และข้อความจะถูกสร้างและบันทึกในโครงสร้างลำดับชั้นเดียวกับบนเซิร์ฟเวอร์ IMAP ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีดึงข้อมูลข้อความและโฟลเดอร์ย่อยแบบเรียกซ้ำ

จัดการข้อมูลพิเศษของข้อความ

ดึงพารามิเตอร์เพิ่มเติมเป็นข้อมูลสรุป

รับข้อมูลหัวข้อ List-Unsubscribe

หัวข้อ List-Unsubscribe มี URL สำหรับยกเลิกการสมัครรับรายชื่ออีเมล เช่น โฆษณา, จดหมายข่าว ฯลฯ เพื่อรับหัวข้อ List-Unsubscribe ให้ใช้ ListUnsubscribe คุณสมบัติของ ImapMessageInfo คลาส ตัวอย่างต่อไปนี้แสดงการใช้ของ ListUnsubscribe คุณสมบัติสำหรับรับหัวข้อ List-Unsubscribe.

Net: กรองข้อความจากเซิร์ฟเวอร์ IMAP ใน C#

Mon, 01 Jan 0001 00:00:00 +0000

การกรองข้อความพื้นฐาน

นี้ ImapClient class ให้ ListMessages() เมธอดที่ดึงข้อความทั้งหมดจากกล่องจดหมาย เพื่อดึงเฉพาะข้อความที่ตรงกับเงื่อนไขบางอย่าง ให้ใช้เมธอดโอเวอร์โหลด ListMessages() เมธอดที่รับ MailQuery เป็นอาร์กิวเมนต์. MailQuery คลาสให้คุณสมบัติต่างๆ สำหรับระบุเงื่อนไข เช่น วันที่, หัวเรื่อง, ผู้ส่ง, ผู้รับ เป็นต้น ตัวอย่างแรกแสดงวิธีกรองข้อความตามวันที่และหัวเรื่อง เรายังแสดงวิธีกรองตามเกณฑ์อื่นและวิธีสร้างคำค้นที่ซับซ้อนมากขึ้น API ยังให้ความสามารถในการใช้เกณฑ์การค้นหาแบบแยกแยะตัวพิมพ์เพื่อให้ตรงกับเงื่อนไขการกรองอย่างแม่นยำ API ยังอนุญาตให้ระบุการเข้ารหัสของสตริงการค้นหาเพื่อกรองข้อความจากกล่องจดหมาย

กรองข้อความจากกล่องจดหมาย

เชื่อมต่อและเข้าสู่ระบบเซิร์ฟเวอร์ IMAP
สร้างอินสแตนซ์ของ MailQuery และตั้งค่าคุณสมบัติ
เรียกใช้ ImapClient.ListMessages(MailQuery query) เมธอดและส่งค่า MailQuery พร้อมพารามิเตอร์เพื่อดึงข้อความที่กรองเท่านั้น.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับกล่องจดหมาย IMAP และดึงข้อความที่มาถึงวันนี้และมีคำว่า "newsletter" ในหัวเรื่อง

กรองข้อความตามเกณฑ์เฉพาะ

ตัวอย่างโค้ดด้านบน กรองข้อความตามหัวเรื่องอีเมลและวันที่ เราสามารถใช้คุณสมบัติเพิ่มเติมเพื่อกำหนดเงื่อนไขที่รองรับอื่น ๆ ด้านล่างเป็นตัวอย่างการตั้งค่าเงื่อนไขโดยใช้ MailQuery. ตัวอย่างโค้ดต่อไปนี้แสดงวิธีกรองอีเมลตาม:

วันที่วันนี้.
ช่วงวันที่.
จากผู้ส่งเฉพาะ.
จากโดเมนเฉพาะ.
จากผู้รับเฉพาะ.

วันที่วันนี้

โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองอีเมลตามวันที่วันนี้.

ช่วงวันที่

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีกรองอีเมลตามช่วงวันที่

ผู้ส่งเฉพาะ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองอีเมลตามผู้ส่งเฉพาะ.

โดเมนเฉพาะ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองอีเมลตามโดเมนเฉพาะ.

ผู้รับเฉพาะ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองอีเมลตามผู้รับเฉพาะ.

การสร้างคิวรีขั้นสูง

หากแตกต่าง MailQueryBuilder คุณสมบัติตั้งค่าในคำสั่งแยกกัน จากนั้นเงื่อนไขทั้งหมดจะตรงกัน ตัวอย่างเช่น หากเราต้องการดึงข้อความระหว่างช่วงวันที่และจากโฮสต์เฉพาะ เราต้องเขียนสามคำสั่ง

รวมคิวรีด้วย AND

โค้ดสแนปต่อไปนี้แสดงวิธีรวมคิวรีด้วย AND

รวมคิวรีด้วย OR

MailQueryBuilder ให้ Or() เมธอดที่รับสอง MailQuery อินสแตนซ์เป็นพารามิเตอร์ มันดึงข้อความที่ตรงกับเงื่อนไขใดเงื่อนไขหนึ่งจากสองเงื่อนไขที่ระบุ โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองข้อความที่มีคำว่า “test” ในหัวเรื่องหรือผู้ส่งเป็น “noreply@host.com” โค้ดตัวอย่างต่อไปนี้แสดงวิธีรวมคำค้นด้วย OR.

การกรองตาม InternalDate

ข้อความสามารถดึงจากเซิร์ฟเวอร์โดยอิงจาก InternalDate อย่างไรก็ตามบางครั้งเซิร์ฟเวอร์อาจไม่ส่งคืนข้อความทั้งหมดตามที่เห็นในกล่องจดหมาย สาเหตุอาจมาจากโซนเวลาของเซิร์ฟเวอร์ที่อาจไม่เป็น UTC สำหรับเซิร์ฟเวอร์บางตัวเช่น Gmail. Aspose ส่งคำสั่งเช่น 008 SEARCH ON 4-May-2014 ตาม โปรโตคอล IMAP อย่างไรก็ตามผลลัพธ์อาจแตกต่างเนื่องจากการตั้งค่าโซนเวลาของเซิร์ฟเวอร์ มีสมาชิกใหม่ถูกเพิ่มใน ImapMessageInfo เป็น InternalDate ซึ่งช่วยเพิ่มเติมในการกรองข้อความ โค้ดตัวอย่างต่อไปนี้แสดงการใช้ InternalDate เพื่อกรองข้อความ.

การกรองแบบแยกแยะตัวพิมพ์

โค้ดตัวอย่างต่อไปนี้แสดงวิธีใช้การกรองอีเมลแบบแยกแยะตัวพิมพ์.

ระบุการเข้ารหัสสำหรับตัวสร้างคำค้นหา

API ของ ImapQueryBuilder คอนสตรัคเตอร์สามารถใช้ระบุการเข้ารหัสสำหรับสตริงการค้นหาได้ สิ่งนี้ยังสามารถตั้งค่าโดยใช้ DefaultEncoding คุณสมบัติของ MailQueryBuilder โค้ดตัวอย่างต่อไปนี้แสดงวิธีระบุการเข้ารหัสสำหรับตัวสร้างคำค้นหา.

ตัวเลือกการกรองแบบกำหนดเอง

กรองข้อความด้วยแฟล็กที่กำหนดเอง

การค้นหาแบบกำหนดเองสำหรับการกรอง

ตัวอย่างเช่น มาตรฐาน RFC 3501 ไม่อนุญาตให้ค้นหาข้อความโดยอิงจากการมีไฟล์แนบในข้อความ แต่ Gmail มีให้ ส่วนขยาย IMAP ซึ่งทำให้สามารถทำการค้นหาเช่นนี้ได้ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างคิวรีที่สอดคล้องกัน

ImapQueryBuilder queryBuilder = new ImapQueryBuilder();
queryBuilder.CustomSearch("X-GM-RAW \"has:attachment\"");

MailQuery mailQuery = queryBuilder.GetQuery();
ImapMessageInfoCollection messageInfoCollection = imapClient.ListMessages(mailQuery);

กรองข้อความด้วยการสนับสนุนการแบ่งหน้า

นี้ ImapClient ให้ความสามารถในการค้นหาข้อความจากกล่องจดหมายและแสดงรายการพร้อมการสนับสนุนการแบ่งหน้า โค้ดตัวอย่างต่อไปนี้แสดงวิธีการกรองข้อความด้วยการแบ่งหน้า.

Net: การจัดการแฟล็กข้อความบนเซิร์ฟเวอร์ IMAP

Mon, 01 Jan 0001 00:00:00 +0000

ตั้งค่า/เปลี่ยนแปลงแฟล็กข้อความ

คุณสามารถเปลี่ยนแฟล็กข้อความโดยตั้งค่าใหม่ด้วย ChangeMessageFlags() วิธีการ. วิธีการนี้รับพารามิเตอร์สองค่า.

หมายเลขลำดับของข้อความหรือ ID ที่ไม่ซ้ำกันของมัน
MessageFlag.

สามารถตั้งค่าแฟล็กต่อไปนี้ได้:

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเปลี่ยนแปลงแฟล็กข้อความบนเซิร์ฟเวอร์ IMAP ด้วย Aspose.Email.

ลบธงข้อความ

แฟล็กข้อความยังสามารถลบได้ด้วย RemoveMessageFlags() เมธอด. การใช้งานคล้ายกับของ ChangeMessageFlags() เมธอด. มันรับลำดับหมายเลขหรือไอดีข้อความที่ไม่ซ้ำและ MessageFlag. ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบแฟล็กข้อความ.

ตั้งค่าแฟล็กที่กำหนดเอง

คุณยังสามารถตั้งค่าแฟล็กแบบกำหนดเองให้กับข้อความโดยใช้ ImapClient ของ API. ImapClient AddMessageFlags ให้ความสามารถในการตั้งค่าแฟล็กที่กำหนดเองบนข้อความ

Net: การจัดการโฟลเดอร์บนเซิร์ฟเวอร์ IMAP

Mon, 01 Jan 0001 00:00:00 +0000

การดำเนินการโฟลเดอร์

รับข้อมูลโฟลเดอร์

การดึงข้อมูลโฟลเดอร์จากเซิร์ฟเวอร์ IMAP ง่ายมากด้วย Aspose.Email เรียก ListFolders() เมธอดของ ImapClient คลาส มันคืนอ็อบเจ็กต์ของ ImapFolderInfoCollection ประเภท. ทำการวนซ้ำผ่านชุดข้อมูลนี้และรับข้อมูลเกี่ยวกับโฟลเดอร์แต่ละรายการในลูป เมธอดนี้มีการโอเวอร์โหลด คุณสามารถส่งชื่อโฟลเดอร์เป็นพารามิเตอร์เพื่อรับรายการโฟลเดอร์ย่อย ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีดึงข้อมูลโฟลเดอร์จากเซิร์ฟเวอร์ IMAP ด้วย Aspose.Email โดยใช้เมธอดที่อธิบายไว้ในข้อมูล

ลบและเปลี่ยนชื่อโฟลเดอร์

โฟลเดอร์บนเซิร์ฟเวอร์ IMAP สามารถลบหรือเปลี่ยนชื่อด้วยบรรทัดเดียวโดยใช้ Aspose.Email:

นี้ DeleteFolder() เมธอดรับชื่อโฟลเดอร์เป็นพารามิเตอร์.
สำหรับ RenameFolder() เมธอด คุณต้องส่งชื่อโฟลเดอร์ปัจจุบันและชื่อโฟลเดอร์ใหม่ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบโฟลเดอร์จากเซิร์ฟเวอร์ IMAP และวิธีเปลี่ยนชื่อโฟลเดอร์ การทำงานแต่ละอย่างทำได้ด้วยบรรทัดโค้ดหนึ่งบรรทัด

ทำงานกับโฟลเดอร์กล่องเมลการใช้พิเศษ

บางที่เก็บข้อความ IMAP มีกล่องเมลที่ใช้พิเศษ เช่น ที่ใช้เก็บข้อความร่างหรือข้อความที่ส่งแล้ว ลูกค้าเมลหลายตัวอนุญาตให้ผู้ใช้กำหนดตำแหน่งที่ควรเก็บร่างหรือข้อความที่ส่งแล้ว แต่การกำหนดค่าต้องให้ผู้ใช้รู้ว่ากล่องเมลใดที่เซิร์ฟเวอร์ได้แยกไว้สำหรับวัตถุประสงค์เหล่านี้ Aspose.Email สามารถระบุกล่องเมลพิเศษเหล่านี้โดยใช้ ImapMailboxInfo คลาสเพื่อให้ง่ายต่อการทำงานกับพวกมัน ตัวอย่างโค้ดต่อไปนี้สาธิตวิธีเข้าถึงกล่องเมลพิเศษเหล่านี้โดยใช้ ImapMailboxInfo คลาส.

การดำเนินการข้อความภายในโฟลเดอร์

เพิ่มข้อความใหม่ลงในโฟลเดอร์

คุณสามารถเพิ่มข้อความใหม่ลงในโฟลเดอร์โดยใช้ MailMessage และ ImapClient คลาส. สร้างแรก MailMessage อ็อบเจกต์โดยระบุค่าหัวเรื่อง, ผู้รับและผู้ส่ง จากนั้นสมัครสมาชิกโฟลเดอร์และเพิ่มข้อความลงในโฟลเดอร์ ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีเพิ่มข้อความใหม่ในโฟลเดอร์

เพิ่มหลายข้อความพร้อม MultiConnection

คุณสามารถเพิ่มหลายข้อความโดยใช้ AppendMessages เมธอดที่ให้โดย ImapClient คลาส. AppendMessages เมธอดรับรายการของ MailMessage และเพิ่มเข้ากับโฟลเดอร์ปัจจุบันหากไม่ได้ระบุโฟลเดอร์เป็นพารามิเตอร์ ImapClient ยังรองรับโหมด MultiConnection สำหรับการทำงานที่หนัก ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มหลายข้อความโดยใช้โหมด MultiConnection.

การย้ายข้อความระหว่างโฟลเดอร์

Aspose.Email สำหรับ .NET อนุญาตให้ย้ายข้อความจากโฟลเดอร์กล่องจดหมายหนึ่งไปยังอีกโฟลเดอร์หนึ่งโดยใช้ ImapClient API. การ MoveMessage วิธีการนี้ใช้รหัสข้อความที่ไม่ซ้ำและชื่อโฟลเดอร์ปลายทางสำหรับการย้ายข้อความไปยังโฟลเดอร์ปลายทาง โค้ดตัวอย่างต่อไปนี้แสดงวิธีการย้ายข้อความไปยังโฟลเดอร์กล่องจดหมายอื่น

คัดลอกข้อความระหว่างโฟลเดอร์

Aspose.Email API มีความสามารถในการคัดลอกข้อความจากโฟลเดอร์กล่องจดหมายหนึ่งไปยังอีกโฟลเดอร์หนึ่ง โดยสามารถคัดลอกข้อความเดี่ยวหรือหลายข้อความโดยใช้ คัดลอกข้อความ และ CopyMessages เมธอด. CopyMessages เมธอดให้ความสามารถในการคัดลอกหลายข้อความจากโฟลเดอร์ต้นทางของกล่องเมลไปยังโฟลเดอร์กล่องเมลปลายทาง ตัวอย่างโค้ดต่อไปนี้แสดงวิธีคัดลอกข้อความไปยังโฟลเดอร์กล่องเมลอื่น.

Net: การดำเนินการ IMAP แบบอะซิงโครนัส: ดึง, จัดการ & ส่งอีเมล

Mon, 01 Jan 0001 00:00:00 +0000

การดำเนินการแบบอะซิงโครนัสกับ ImapClient

การทำงานกับข้อความสามารถทำได้แบบอะซิงโครนัสด้วยการใช้ Aspose.Email ImapClient. บทความนี้แสดงการดึงข้อความจากกล่องจดหมายแบบอะซิงโครนัส และแสดงวิธีแสดงรายการข้อความโดยกำหนดเงื่อนไขการค้นหาโดยใช้ MailQuery. จะมีการแสดงแยกต่างหากว่าจะแทรกการดำเนินการของข้อความอีเมลที่เริ่มด้วยรูปแบบอะซิงโครนัสแบบ task-based (TAP) เมธอด.

ดึงข้อความแบบอะซิงโครนัส

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการดึงข้อความแบบอะซิงโครนัส.

List Messages Asynchronously with MailQuery

นี้ MailQuery คลาสสามารถใช้ระบุเงื่อนไขการค้นหาเพื่อดึงรายการข้อความที่ระบุแบบอะซิงโครนัส ตามที่แสดงในตัวอย่างโค้ดต่อไปนี้

ส่งข้อความแบบไม่ประสานงาน

การส่งอีเมลแบบอะซิงโครนัสเป็นสิ่งที่สะดวกมาก เพราะกระบวนการนี้ไม่บล็อกการทำงานของโปรแกรมหรือเธรด แทนที่จะรอให้อีเมลส่งเสร็จก่อนทำงานอื่น โปรแกรมสามารถทำงานต่อได้ขณะอีเมลกำลังส่งในพื้นหลัง

คุณสมบัติดังต่อไปนี้จะช่วยคุณทำการส่งแบบอะซิงโครนัสในโปรเจกต์ของคุณ:

IAsyncImapClient - อนุญาตให้แอปพลิเคชันเข้าถึงและจัดการข้อความโดยใช้โปรโตคอล IMAP (Internet Message Access Protocol).
ImapClient.CreateAsync - สร้างอินสแตนซ์ใหม่ของคลาส Aspose.Email.Clients.Imap.ImapClient

ตัวอย่างโค้ดด้านล่างนี้แสดงวิธีแสดงรายการข้อความในพื้นหลัง:

// Authenticate the client to obtain necessary permissions
static readonly string tenantId = "YOU_TENANT_ID";
static readonly string clientId = "YOU_CLIENT_ID";
static readonly string redirectUri = "http://localhost";
static readonly string username = "username";
static readonly string[] scopes = { "https://outlook.office.com/IMAP.AccessAsUser.All" };

// Use the ImapAsync method for asynchronous operations
static async Task Main(string[] args)
{
    await ImapAsync();
    Console.ReadLine();
}

// Establish the connection with the server
// Create an instance of the ImapClient asynchronously using the CreateAsync method
// Select the Inbox folder using SelectFolderAsync method to complete and fetch the list of email messages asynchronously using the ListMessagesAsync method.
static async Task ImapAsync()
{
    var tokenProvider = new TokenProvider(clientId, tenantId, redirectUri, scopes);
    var client = ImapClient.CreateAsync("outlook.office365.com", username, tokenProvider, 993).GetAwaiter().GetResult();
    await client.SelectFolderAsync(ImapFolderInfo.InBox);
    var messages = await client.ListMessagesAsync();
    Console.WriteLine("Messages :" + messages.Count);
}

// Token provider implementation
public class TokenProvider : IAsyncTokenProvider
{
    private readonly PublicClientApplicationOptions _pcaOptions;
    private readonly string[] _scopes;

    public TokenProvider(string clientId, string tenantId, string redirectUri, string[] scopes)
    {
        _pcaOptions = new PublicClientApplicationOptions
        {
            ClientId = clientId,
            TenantId = tenantId,
            RedirectUri = redirectUri
        };

        _scopes = scopes;
    }

    public async Task<OAuthToken> GetAccessTokenAsync(bool ignoreExistingToken = false, CancellationToken cancellationToken = default)
    {

        var pca = PublicClientApplicationBuilder
            .CreateWithApplicationOptions(_pcaOptions).Build();

        try
        {
            var result = await pca.AcquireTokenInteractive(_scopes)
                .WithUseEmbeddedWebView(false)
                .ExecuteAsync(cancellationToken);

            return new OAuthToken(result.AccessToken);
        }
        catch (MsalException ex)
        {
            Console.WriteLine($"Error acquiring access token: {ex}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex}");
        }

        return null;
    }

    public void Dispose()
    {

    }
}

การจัดการการดำเนินการแบบอะซิงโครนัส

ขัดจังหวะเมธอด TAP

ตั้งแต่ .NET Framework 4.5 เป็นต้นไป คุณสามารถใช้เมธอดแบบอะซิงโครนัสที่ทำตามโมเดล TAP ตัวอย่างโค้ดด้านล่างแสดงวิธีเพิ่มหลายข้อความโดยใช้เมธอดแบบ task-based asynchronous pattern ที่ชื่อ AppendMessagesAsync และจากนั้นขัดจังหวะกระบวนการนี้หลังจากสักครู่.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

List<MailMessage> mailMessages = new List<MailMessage>();

// create mail messages
for (int i = 0; i < 100; i++)
    mailMessages.Add(new MailMessage(senderEmail, receiverEmail, $"Message #{i}", "Text"));

using (ImapClient client = new ImapClient(host, 993, senderEmail, password, SecurityOptions.SSLImplicit))
{
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
    AutoResetEvent autoResetEvent = new AutoResetEvent(false);
    Exception exception = null;

    ThreadPool.QueueUserWorkItem(delegate
    {
        try
        {
            // start uploading the messages
            var task = client.AppendMessagesAsync(mailMessages, cancellationTokenSource.Token);
            AppendMessagesResult appendMessagesResult = task.GetAwaiter().GetResult();
            Console.WriteLine("All messages have been appended.");
        }
        catch (Exception e)
        {
            exception = e;
        }
        finally
        {
            autoResetEvent.Set();
        }
    });

    Thread.Sleep(5000);

    // stop uploading the messages
    cancellationTokenSource.Cancel();
    autoResetEvent.WaitOne();

    foreach (MailMessage mailMessage in mailMessages)
        mailMessage.Dispose();

    if (exception is OperationCanceledException)
        Console.WriteLine("Operation has been interrupted: " + exception.Message);
}

ยกเลิกการดำเนินการแบบอะซิงโครนัส

บางครั้งคุณอาจต้องหยุดการดำเนินการแบบอะซิงโครนัส เพื่อจุดประสงค์นี้ไลบรารีของเรามีการยกเลิกการดำเนินการแบบอะซิงโครนัสผ่านพารามิเตอร์ CancellationToken เมื่อเรียกเมธอดอะซิงโครนัสที่รองรับการยกเลิก คุณสามารถส่งอินสแตนซ์ของ CancellationToken เป็นพารามิเตอร์ได้ CancellationToken ใช้เพื่อสัญญาณและควบคุมการยกเลิกการดำเนินการ

เพื่อเปิดใช้งานการยกเลิก คุณต้องสร้างอินสแตนซ์ของ CancellationTokenSource ที่ให้ CancellationToken ก่อน จากนั้นส่ง CancellationToken ไปยังเมธอดอะซิงโครนัส เพื่อให้เมธอดตรวจสอบคำขอยกเลิกระหว่างการทำงาน

นี่คือตัวอย่างที่แสดงการยกเลิกโดยใช้ CancellationToken:

CancellationTokenSource tokenSource = new CancellationTokenSource();
AppendMessagesResult appendMessagesResult = null;
AutoResetEvent autoResetEvent = new AutoResetEvent(false);
ThreadPool.QueueUserWorkItem(delegate(object state)
    {
        try
        {
            appendMessagesResult = imapClient.AppendMessagesAsync(mmList, tokenSource.Token).GetAwaiter().GetResult();
        }
        catch (Exception ex)
        {

        }
        finally
        {
            autoResetEvent.Set();
        }
    });

tokenSource.Cancel();
autoResetEvent.WaitOne();

Net: วิธีเปิดการบันทึกกิจกรรม IMAP

Mon, 01 Jan 0001 00:00:00 +0000

การบันทึกกิจกรรมใช้สำหรับการดีบัก รวมถึงการเก็บและวิเคราะห์ข้อมูลการทำงานของไคลเอนต์ IMAP

เปิดใช้งานการบันทึกกิจกรรม

ใช้ไฟล์ appsettings.json เพื่อเปิดใช้งานการบันทึกกิจกรรม

หมายเหตุ: ตัวเลือกนี้แนะนำสำหรับแอปพลิเคชัน .NET Core.

การบันทึก ImapClient สามารถเปิดใช้งานได้ด้วยขั้นตอนและตัวอย่างโค้ดต่อไปนี้:

เพิ่มไฟล์การกำหนดค่า appsettings.json ไปยังโครงการ C# หากยังไม่ได้เพิ่มมาก่อน
ตรวจสอบให้แน่ใจว่าไฟล์โครงการมีบรรทัดต่อไปนี้ในส่วน ItemGroup.
```
   <Content Include="appsettings.json">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
   </Content>
```
จากนั้นเพิ่มเนื้อหาต่อไปนี้ลงในไฟล์ appsettings.json.
```
   {
     "ImapDiagnosticLog": "imap.log",
     "ImapDiagnosticLog_UseDate": true
   }
```

สองคุณสมบัติที่กล่าวถึงข้างต้นคือ:

ImapDiagnosticLog - ระบุพาธสัมพันธ์หรือพาธเต็มของไฟล์บันทึก.
ImapDiagnosticLog_UseDate - ระบุว่าจะเพิ่มการแสดงวันที่ปัจจุบันเป็นสตริงลงในชื่อไฟล์บันทึกหรือไม่.

เปิดใช้งานการบันทึกกิจกรรมในโค้ดโปรแกรม

คุณยังสามารถเปิดการบันทึกได้ทันทีในโค้ด.

หมายเหตุ: แม้ว่าคุณจะเปิดการบันทึกแล้วโดยใช้ไฟล์การกำหนดค่า ตัวเลือกนี้ยังคงถูกนำไปใช้.

การบันทึก ImapClient สามารถเปิดใช้งานได้ด้วยขั้นตอนและตัวอย่างโค้ดต่อไปนี้:

สร้าง ImapClient.
ตั้งค่าพาธไปยังไฟล์บันทึกโดยใช้ LogFileName คุณสมบัติ.
ตั้งค่า UseDateInLogFileName คุณสมบัติหากจำเป็น.

   using (var client = new ImapClient("your imap server", 993, "your username", "your password"))
{
    // Set security mode
    client.SecurityOptions = SecurityOptions.Auto;

    // Set the path to the log file using the LogFileName property.
    client.LogFileName = @"C:\Aspose.Email.IMAP.log";

    // Set the UseDateInLogFileName property if it is necessary.
    client.UseDateInLogFileName = false;
}

ใช้ไฟล์ App.config เพื่อเปิดใช้งานการบันทึกกิจกรรม

ImapClient กิจกรรมสามารถบันทึกได้โดยการแก้ไข configSections ในไฟล์ config ขั้นตอนต่อไปนี้เป็นวิธีทำการบันทึกการตรวจสอบ:

เพิ่ม sectionGroup ชื่อ "applicationSettings".
เพิ่ม section ชื่อ "Aspose.Email.Properties.Settings".
รวมการตั้งค่า ImapDiagonosticLog ซึ่งชื่อไฟล์ถูกกำหนดใน applicationSettings/Aspose.Email.Properties.Settings.

นี่คือตัวอย่างแอปพลิเคชันฟอร์มที่ใช้ ImapClient เพื่อประมวลผลเมล กิจกรรมทั้งหมดนี้จะถูกบันทึกโดยการแก้ไขไฟล์ App.config

สร้างแอปพลิเคชันแบบฟอร์มที่มีปุ่มเดียว เพิ่มโค้ดตัวอย่างต่อไปนี้สำหรับเหตุการณ์คลิกของปุ่ม:

เพิ่มการอ้างอิงไปยัง Aspose.Email.

ตอนนี้เพิ่มไฟล์ App.Config และแก้ไขให้เนื้อหาไฟล์เป็นดังต่อไปนี้:

สำหรับ C# .NET ใช้ตัวเลือกต่อไปนี้

|| | | :- | :- | สำหรับ VB .NET ใช้ตัวเลือกต่อไปนี้

รันโค้ดแล้วสังเกตโฟลเดอร์ Log ไฟล์ต่อไปนี้จะถูกสร้างขึ้น

Net: ตรวจสอบความถูกต้องของข้อมูลรับรองเซิร์ฟเวอร์เมล IMAP ด้วย .NET API

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email API ช่วยให้ตรวจสอบข้อมูลรับรองเซิร์ฟเวอร์เมลได้โดยไม่ต้องส่งอีเมล ValidateCredentials เมธอดนี้รับผิดชอบในการตรวจสอบความถูกต้องและความเป็นจริงของข้อมูลรับรองอีเมลที่ให้ไว้ ซึ่งโดยทั่วไปใช้สำหรับการยืนยันตัวตนเมื่อเชื่อมต่อกับเซิร์ฟเวอร์

มันตรวจสอบว่าข้อมูลรับรองอีเมลที่ให้ไว้ เช่น ชื่อผู้ใช้และรหัสผ่าน ถูกต้องและว่าผู้ใช้สามารถเชื่อมต่อกับเซิร์ฟเวอร์ได้สำเร็จ การตรวจสอบข้อมูลรับรองนี้ช่วยให้มั่นใจว่าผู้ใช้สามารถเข้าถึงบัญชีอีเมลอย่างปลอดภัยและทำการดำเนินการต่าง ๆ เช่น รับอีเมล

using (ImapClient client = new ImapClient(server.ImapUrl, server.ImapPort, "username", "password", SecurityOptions.Auto))
{
    client.Timeout = 4000;
   
    if (client.ValidateCredentials())
    {
        //to do something
    }
}

สำหรับการดำเนินการแบบอะซิงโครนัส มีเวอร์ชันของเมธอดนี้ด้วย ValidateCredentialsAsync.

Net: การสำรองและกู้คืนข้อมูล IMAP

Mon, 01 Jan 0001 00:00:00 +0000

การสำรองและกู้คืนแบบมาตรฐาน

Aspose.Email สำหรับ .NET ให้ความสามารถในการสำรองและกู้คืนข้อความ สำหรับเรื่องนี้ API มีเมธอดต่อไปนี้

บทความนี้สาธิตวิธีการสำรองและกู้คืนข้อความโดยใช้ ImapClient คลาส.

สำรองข้อความ

เพื่อสำรองข้อความ ให้ใช้ ImapClient.Backup วิธีการตามที่แสดงในโค้ดตัวอย่างต่อไปนี้

กู้คืนข้อความ

เพื่อกู้คืนข้อความ ใช้ ImapClient.Restore วิธีการตามที่แสดงในโค้ดตัวอย่างต่อไปนี้

การสำรองและกู้คืน IMAP ด้วย MultiConnection

เมื่อทำงานกับข้อความจำนวนมาก การสำรอง/กู้คืนข้อมูลอาจใช้เวลานาน สำหรับกรณีนี้ API ให้การสนับสนุนการเชื่อมต่อหลายครั้งระหว่างการสำรองและการกู้คืน เพื่อเปิดใช้งานโหมด MultiConnection ให้ตั้งค่า ImapClient.UseMultiConnection คุณสมบัติสำหรับ MultiConnectionMode.Enable. โค้ดตัวอย่างต่อไปนี้สาธิตการสำรองและกู้คืนข้อมูลโดยเปิดใช้งานโหมด MultiConnection

ตัวอย่างโค้ดต่อไปนี้แสดง การสำรองข้อมูล โดยเปิดโหมด MultiConnection

ตัวอย่างโค้ดต่อไปนี้แสดง การกู้คืน โดยเปิดโหมด MultiConnection

Net: วิธีลบข้อความจากเซิร์ฟเวอร์ IMAP ด้วย .NET Core

Mon, 01 Jan 0001 00:00:00 +0000

ลบข้อความ

นี้ ImapClient คลาสนี้สามารถลบข้อความจากเซิร์ฟเวอร์ IMAP. ImapClient คลาส DeleteMessage() ฟังก์ชันนี้ใช้เพื่อลบข้อความ มันรับลำดับหมายเลขข้อความหรือไอดีที่ไม่ซ้ำเป็นพารามิเตอร์. ImapClient ให้บริการ DeleteMessage และ DeleteMessages เมธอดสำหรับลบข้อความทีละหนึ่งหรือหลายข้อความ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีลบอีเมลที่มี ID ข้อความเป็น 1 จากเซิร์ฟเวอร์ IMAP.

using var client = new ImapClient("host", "username", "password");
client.SecurityOptions = SecurityOptions.SSLImplicit;

// Append test message
client.SelectFolder(ImapFolderInfo.InBox);

var eml = new MailMessage("from@from.com", "to@to.com")
{
  Subject = "Message to delete",
  Body = "Hey! This Message will be deleted!"
};
var emlId = client.AppendMessage(eml);

// Delete appended message
client.DeleteMessage(emlId);
client.CommitDeletes();

การลบหลายข้อความ

อีเมลหลายฉบับสามารถลบจากกล่องจดหมายโดยใช้ ImapClient ของ API Aspose.Email. DeleteMessages เมธอดนี้ให้ตัวเลือกหลายอย่างเพื่อทำการลบหลายข้อความจากเซิร์ฟเวอร์โดยใช้ไอดีที่ไม่ซ้ำกัน ลำดับหมายเลข หรือ ImapMessageInfoCollection อิลิเมนต์ ต่อไปนี้เป็นตัวอย่างโค้ดที่แสดงวิธีลบหลายข้อความ

using var client = new ImapClient("host", "username", "password");
client.SelectFolder(ImapFolderInfo.InBox);
            
// Append test messages
var emlList = new List<MailMessage>();
{
  var eml = new MailMessage("from@from.com", "to@to.com")
  {
    Subject = $"Message to delete {i}",
    Body = "Hey! This Message will be deleted!"
  };
                
  emlList.Add(eml);
}

var appendMessagesResult = client.AppendMessages(emlList);
            
// Bulk Delete appended Messages
client.DeleteMessages(appendMessagesResult.Succeeded.Values, true);
client.CommitDeletes();