Documentation – บทความเชิงเทคนิค

Net: ทำไมต้อง Aspose.Email

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

Net: การเปรียบเทียบ Aspose.Email.Mail กับ MS APIs

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

การเปรียบเทียบ Aspose Email Mail กับ MS APIs

System.Web.Mail เป็นเพียงตัวหุ้มรอบสองไลบรารี COM: CDONTS.NewMail (พบใน cdonts.dll) และ CDO.Message (พบใน cdosys.dll) คุณจะต้องติดตั้งมันบนเซิร์ฟเวอร์ของคุณด้วย โดยค่าเริ่มต้น cdonts.dll และ cdosys.dll จะถูกติดตั้งมาพร้อมกับ WindowsNT/2000/XP/2003

รายละเอียดของ SmtpMail

หากคุณเข้าไปสืบค้นคลาส System.Web.Mail.SmtpMail คุณจะพบพฤติกรรมแปลกๆ บางประการ:

มันรองรับเฉพาะระบบปฏิบัติการ Win32NT เท่านั้น เช่น Windows 2000, Windows 2003, Windows XP.
เมื่อคลาส SmtpMail ส่งข้อความอีเมล มันจะตรวจสอบเวอร์ชันของ OS หากเวอร์ชัน <= 4 จะใช้วัตถุ CDONTS.Newmail; สำหรับระบบปฏิบัติการที่มีเวอร์ชันมากกว่า 4 จะใช้วัตถุ CDO.Message

ลักษณะเฉพาะเหล่านี้ทำให้การแก้ไขปัญหายากขึ้นอย่างมาก โดยเฉพาะเมื่อย้ายโค้ดไปยังระบบปฏิบัติการที่ต่างกัน แอปพลิเคชันอาจได้รับผลลัพธ์ที่ไม่คาดคิดบน OS ที่ต่างกัน Aspose.Email.Mail เป็นคอมโพเนนต์ .NET ที่เขียนด้วยโค้ดจัดการเต็มรูปแบบในภาษา C# แท้ ซึ่งไม่มีการพึ่งพาไลบรารี COM ใด ๆ รวมถึง CDONTS.NewMail หรือ CDO.Message ด้วย Aspose.Email.Mail คุณจะหลีกเลี่ยงการเรียกโค้ดที่ไม่จัดการในแอปพลิเคชันของคุณ ทำให้ความน่าเชื่อถือเพิ่มขึ้นและหลีกเลี่ยงการดีบัก COM ที่น่าเบื่อ Aspose.Email.Mail มีคุณสมบัติครบถ้วนและให้บริการมากกว่าที่สถาปัตยกรรม System.Web.Mail มีให้ System.Net.Mail เป็นการนำไปใช้ไคลเอนต์โปรโตคอล SMTP รุ่นใหม่ใน .NET 2.0 ซึ่งก็เป็นการนำไปใช้โค้ดจัดการเต็มรูปแบบใน C# ด้วยเช่นกัน

เมทริกซ์การเปรียบเทียบ

คุณลักษณะ	Aspose.Email.Mail	System.Web.Mail	System.Net.Mail
Compatibility Features
Supports .NET 2.0	X	X	X
Common Features
CDO/CDONTS Dependency		X
Pure Managed Code	X		X
Authentication	X	X	X
Sender address	X	X	X
Recipients address	X	X	X
HTML Body	X	X	X
Text Body	X	X	X
Bcc/Cc	X	X	X
Send Attachment	X	X	X
Linked Image	X		X
Body Encoding (Unicode/ASCII)	X	X	X
Subject Encoding (Unicode/ASCII)	X		X
Synchronous programming model	X		X
Asynchronous programming model	X		X
Unique Features
Customized Mail Header	X
Importance Header	X
Sensitivity Header	X
X-Mailer Header	X
Reply to	X
Send Date	X
Template-based Mail Merge	X
Mail Merge from DataSet	X
Mail Merge from DataTable	X
Mail Merge from DataReader	X
Bulk Send with Multi-threading	X
Send Calendar	X
Send Meeting request	X
Load from Microsoft Msg format	X
Load from Microsoft Mht format	X
Save to Microsoft Mht format	X
Save to Eml format	X
Load from Eml format	X
Load from RFC 822 compliant file	X
Interoperation Features
Works with Aspose.Email.Pop3	X
Works with Aspose.Email.Imap	X
Works with Aspose.Email.Mime	X

Net: ความแตกต่างระหว่าง POP3 และ IMAP

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

ความแตกต่างระหว่าง POP3 และ IMAP

ด้านล่างเป็นคำอธิบายเกี่ยวกับความแตกต่างทั่วไประหว่างโปรโตคอลอีเมล IMAP และ POP3

POP3 และ IMAP

POP3 และ IMAP เป็นโปรโตคอลอีเมลที่ทำงานกับไคลเอนต์อีเมลสมัยใหม่ส่วนใหญ่ ความแตกต่างหลักคือวิธีการจัดการและจัดเก็บอีเมล

POP3

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

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

บัญชี IMAP

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

เก็บเมลบนเซิร์ฟเวอร์ vs. ลบเมลจากเซิร์ฟเวอร์

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

ทำไมต้องเลือก IMAP แทน POP3 และเก็บอีเมลบนเซิร์ฟเวอร์? ด้วย POP3 ข้อความอีเมลของคุณจะอยู่บนเซิร์ฟเวอร์เท่านั้น แต่ด้วย IMAP โฟลเดอร์อีเมลของคุณก็อยู่บนเซิร์ฟเวอร์เช่นกัน.

Net: การเข้าถึง Gmail บน SSL

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

SMTP

บทความนี้แสดงวิธีดำเนินการ เชื่อมต่อกับเซิร์ฟเวอร์ Gmail และ ส่งอีเมล โดยใช้โปรโตคอล SMTP บน SSL.

เชื่อมต่อกับเซิร์ฟเวอร์ SMTP ของ Gmail

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับเซิร์ฟเวอร์ SMTP ที่เปิดใช้ SSL.

การส่งข้อความอีเมล

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

IMAP

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

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

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

ใช้ Aspose.Email’s ImapClient อ็อบเจ็กต์ของคลาสเพื่อเชื่อมต่อกับเซิร์ฟเวอร์เมล จำเป็นต้องระบุที่อยู่ของเซิร์ฟเวอร์, พอร์ต, ชื่อผู้ใช้และรหัสผ่านเพื่อสร้างการเชื่อมต่อ Gmail ใช้พอร์ต 993 สำหรับโปรโตคอล IMAP โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับ Gmail ด้วยพอร์ตนั้น

การเลือกโฟลเดอร์และรับจำนวนข้อความทั้งหมด

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

บันทึกข้อความลงไดรฟ์ฮาร์ดดิสก์ท้องถิ่น

เมื่อเลือกโฟลเดอร์ด้วยเมธอด SelectFolder แล้ว ใช้ฟังก์ชัน ListMessages เพื่อรับรายการของข้อความทั้งหมดในโฟลเดอร์เป็นอ็อบเจ็กต์ ImapMessagesInfoCollection จากนั้นวนลูปผ่านคอลเลคชันนี้และบันทึกข้อความอีเมลไปยังไดรฟ์ท้องถิ่นของคอมพิวเตอร์ดังต่อไปนี้:

สร้างโฟลเดอร์ใหม่

โปรโตคอล IMAP ยังอนุญาตให้คุณสร้างโฟลเดอร์ใหม่บนเซิร์ฟเวอร์เมล ซึ่งทำได้โดยการเรียกฟังก์ชันง่าย ๆ

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

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

POP3

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

ตัวอย่างโค้ดด้านล่างแสดงวิธีการ:

เชื่อมต่อกับเซิร์ฟเวอร์ SSL.
ตรวจสอบสถานะกล่องจดหมาย
รับข้อมูลเกี่ยวกับข้อความ
ดึงอีเมล.

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

เชื่อมต่อกับเซิร์ฟเวอร์เมลที่เปิดใช้ SSL โดยใช้ Pop3client คลาสตามที่อธิบายด้านล่าง.

ตรวจสอบสถานะกล่องจดหมาย

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

ตรวจสอบข้อมูลข้อความ

ตัวอย่างนี้ตรวจสอบข้อความทั้งหมดในกล่องจดหมายโดยใช้ Pop3MessageInfoCollection คลาส ใช้ Pop3Client.ListMessages() ฟังก์ชันเพื่อรับ Pop3MessageInfoCollection คอลเลกชัน จากนั้นวนผ่านคอลเลกชันเพื่ออ่านข้อมูลข้อความ: ID ของข้อความ, ดัชนี, หัวเรื่องและขนาด

ดึงข้อความ

เพื่อดึงข้อความจากกล่องจดหมาย ใช้ Pop3Client เมธอด FetchMessage() ของคลาสเพื่อรับข้อความเข้าสู่ MailMessage อ็อบเจ็กต์ประเภทนี้ โค้ดสแนปต่อไปนี้แสดงวิธีการนับจำนวนอีเมลในกล่องจดหมายและจากนั้นวนผ่านเพื่อดึงแต่ละอีเมลออกมา

Net: แนะนำรูปแบบการทำซ้ำ

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

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

ทุกวันศุกร์ที่ 2, ยกเว้นตั้งแต่เดือนมิถุนายนถึงสิงหาคม.
วันแรกของทุกเดือน, ยกเว้นเดือนมกราคม, ซึ่งควรเป็นวันที่ 2.

รูปแบบการเกิดซ้ำมักจะเป็นแบบเป็นช่วงเวลา, แต่ไม่จำเป็นต้องเป็นเช่นนั้น. รูปแบบการเกิดซ้ำสามารถอธิบายได้อย่างสมบูรณ์โดยเป็นชุดของวันที่และเวลาเกิดเหตุที่กำหนดล่วงหน้า. RFC ของ iCalendar กำหนด components เช่น VEVENT หรือ VTODO ที่แสดงถึงเหตุการณ์หรือภารกิจ. ส่วนประกอบเหล่านี้สามารถมีคุณสมบัติเช่น วันที่เริ่มต้น, คำอธิบาย, สถานที่, ผู้เข้าร่วมและการเกิดซ้ำ. ดังนั้นรูปแบบการเกิดซ้ำโดยทั่วไปจะอยู่เป็นคุณสมบัติของงานที่เกิดซ้ำหรือเหตุการณ์. คุณสมบัติของรูปแบบการเกิดซ้ำที่กำหนดโดย iCalendar มีดังนี้:

DTSTART - วันที่และเวลาเริ่มต้นของรูปแบบ (ยังเป็นการแทนเหตุการณ์แรกหากไม่ได้ยกเว้นโดยชัดเจน).
RRULE - ระบุกฎการทำซ้ำสำหรับชุดการทำซ้ำ.
RDATE - กำหนดรายการของวันและเวลาเพื่อรวมในชุดการทำซ้ำ.
EXRULE - ระบุกฎการทำซ้ำสำหรับข้อยกเว้นจากชุดการทำซ้ำ.
EXDATE - กำหนดรายการของวันและเวลาที่ยกเว้นจากชุดการทำซ้ำ.

ต้องมีเพียง DTSTART เท่านั้นและต้องมีเพียงหนึ่งค่า DTSTART ส่วนคุณสมบัติอื่น ๆ เป็นออปชันและสามารถระบุหลายครั้ง Aspose.iCalendar รับสตริงในรูปแบบ iCalendar และอ่านรูปแบบการทำซ้ำเข้าไปใน RecurrencePattern อ็อบเจ็กต์ สตริงสามารถเป็นคำอธิบายเต็มรูปแบบของคอมโพเนนท์ iCalendar (เช่น VEVENT ที่สมบูรณ์) หรืออาจเป็นเพียงส่วนย่อยที่มีรูปแบบการทำซ้ำเท่านั้น เมื่อรูปแบบการทำซ้ำโหลดเข้าสู่ RecurrencePattern object แล้ว คุณสามารถ:

ตรวจสอบและแก้ไขรูปแบบโดยโปรแกรมผ่านเมธอดและคุณสมบัติที่ Aspose.iCalendar ให้มา
สร้างวันที่/เวลาเกิดเหตุในช่วงวันที่ที่ระบุ.
บันทึกรูปแบบในรูปแบบ iCalendar.

โค้ดสแนปต่อไปนี้แสดงส่วน RRULE ที่มีกฎการทำซ้ำ.

ดูที่ รูปแบบการเกิดซ้ำตัวอย่าง สำหรับภาพอธิบายวิธีสร้างรูปแบบการเกิดซ้ำ.

เกี่ยวกับโมเดลวัตถุ Aspose.iCalendar

เนมสเปซ Aspose.iCalendar มีคลาสทั้งหมดที่จัดหาโดยคอมโพเนนท์ Aspose.iCalendar. RecurrencePattern และ RecurrenceRule เป็นคลาสหลักของ Aspose.iCalendar, และให้การนำไปใช้ที่เป็นรูปธรรมขององค์ประกอบ RFC 2445 ที่สอดคล้อง.

คลาส RecurrencePattern แสดงถึงรูปแบบการเกิดซ้ำทั้งหมด. คุณสามารถสร้างรูปแบบการเกิดซ้ำใหม่จากศูนย์โดยใช้คอนสตรัคเตอร์เริ่มต้นหรือโหลดรูปแบบที่มีอยู่ในรูปแบบ iCalendar ด้วยเมธอดสแตติก FromiCalendar. คลาส RecurrenceRule แสดงส่วน RRULE หรือ EXRULE ของรูปแบบการเกิดซ้ำ. RecurrenceRule เปิดเผยคุณสมบัติจำนวนหลายรายการที่แมพตรงกับมาตรฐาน iCalendar. ตัวอย่างเช่น, ByMonth แมพกับ BYMONTH ใน iCalendar เป็นต้น. โดยการตรวจสอบหรือกำหนดค่าคุณสมบัติของ RecurrenceRule คุณสามารถวิเคราะห์หรือแก้ไขกฎการเกิดซ้ำ. สำหรับข้อมูลเพิ่มเติมและตัวอย่างโค้ด, ดู RecurrencePattern และ RecurrenceRule ใน API Reference.

รูปแบบตัวอย่าง

ส่วนนี้มีหัวข้อต่อไปนี้:

วันสุดท้ายของเดือน.
วันทำงานสุดท้ายของทุกเดือน.
วันจันทร์สุดท้ายของปี.
วันศุกร์ของสัปดาห์ ISO 8601 แรกของปี.
วันศุกร์แรกของปี.

วันสุดท้ายของเดือน

ตัวอย่างเหล่านี้ รูปแบบการเกิดซ้ำ กำหนดวันสุดท้ายของเดือน, ทุกเดือน.

RRULE:FREQ=MONTHLY;BYMONTHDAY=-1

เช่นเดียวกัน, หากคุณต้องการเหตุการณ์ในวันที่ก่อนวันสุดท้ายของเดือน, ใช้ BYMONTHDAY=-2. หากคุณระบุ BYMONTHDAY=31 ตามมาตรฐาน iCalendar จะไม่มีเหตุการณ์เกิดขึ้นในเดือนที่มีน้อยกว่า 31 วัน.

วันทำงานสุดท้ายของทุกเดือน

ตัวอย่างเหล่านี้ รูปแบบการเกิดซ้ำ กำหนดวันทำงานสุดท้ายของเดือน, ทุกเดือน. วันทำงานถูกกำหนดเป็นวันที่คุณทำงาน. ตัวอย่างเช่นในยุโรป, วันทำงานมักเป็นวันจันทร์ถึงศุกร์.

RRULE:FREQ=MONTHLY;BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-1

กฎด้านบนกำหนดวันทำงานทั้งหมดของเดือนและเลือกวันทำงานสุดท้าย. ผลลัพธ์คือวันทำงานสุดท้ายของเดือน.

วันจันทร์สุดท้ายของปี

ตัวอย่างนี้ รูปแบบการเกิดซ้ำ กำหนดเหตุการณ์ที่เกิดขึ้นในวันจันทร์สุดท้ายของปี.

RRULE:FREQ=YEARLY;BYDAY=-1MO

วันศุกร์ของสัปดาห์ ISO 8601 แรกของปี

ตัวอย่างนี้ รูปแบบการเกิดซ้ำ กำหนดวันศุกร์ของสัปดาห์แรกของปี. ตามสเปค ISO 8601, สัปดาห์แรกของปีคือสัปดาห์ที่มีอย่างน้อยสี่วัน. เมื่อปีเริ่มต้นในวันเสาร์, ตัวอย่างเช่น, สัปดาห์ที่ 1 จะเป็นสัปดาห์ถัดไปทันที, เริ่มต้นจากวันจันทร์ที่ 3 มกราคม.

FREQ=YEARLY;BYWEEKNO=1;BYDAY=FR

วันศุกร์แรกของปี

ตัวอย่างนี้ รูปแบบการเกิดซ้ำ กำหนดเหตุการณ์ที่เกิดขึ้นในวันศุกร์แรกของปี.

FREQ=YEARLY;BYDAY=1FR

ในปี 1999, ตัวอย่างเช่น, วันศุกร์แรกของปีคือ 1999/01/01, ขณะที่วันศุกร์ของสัปดาห์ ISO 8601 แรกคือ 1999/01/08.

Net: รายละเอียดสำคัญของ iCalendar RFC 2445

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

เกี่ยวกับโมเดลวัตถุ Aspose.iCalendar

นี้ Aspose.iCalendar เนมสเปซมีคลาสทั้งหมดที่จัดหาโดยคอมโพเนนท์ Aspose.iCalendar. RecurrencePattern และ RecurrenceRule เป็นคลาสหลักของ Aspose.iCalendar, และให้การนำไปใช้ที่เป็นรูปธรรมขององค์ประกอบ RFC 2445 ที่สอดคล้อง.

รายละเอียดสำคัญของ iCalendar RFC 2445

ส่วนนี้มีหัวข้อต่อไปนี้:

รูปแบบวันที่และเวลา.
DATE.
DATE-TIME พร้อมเวลาในท้องถิ่น.
DATE-TIME พร้อมเวลา UTC.
DATE-TIME พร้อมเวลาในท้องถิ่นและโซนเวลา.
BYWEEKNO ให้การปฏิบัติตาม ISO 8601

รูปแบบวันที่และเวลา

วันที่ หรือวันที่พร้อมเวลาที่เกี่ยวข้อง สามารถใช้ในองค์ประกอบ DTSTART, UNTIL, EXDATE และ RDATE เมื่อกำหนดรูปแบบการทำซ้ำ iCalendar กำหนดประเภทค่า DATE เพื่อระบุค่าที่มีวันที่ปฏิทิน และกำหนดประเภทค่า DATE-TIME เพื่อระบุค่าที่ระบุวันที่และเวลาที่แน่นอนของวัน ค่าของ DATE-TIME สามารถระบุได้ในสามรูปแบบ ได้แก่

เวลาในท้องถิ่น.
เวลา UTC.
เวลาในท้องถิ่นและโซนเวลา.

DATE

ตามมาตรฐาน iCalendar ค่ของ DATE ต้องอยู่ในรูปแบบ yyyyMMdd ตัวอย่างต่อไปนี้แสดงวันที่ 14 กรกฎาคม 1997: 19970714

DATE-TIME พร้อมเวลาในท้องถิ่น

รูปแบบวันที่พร้อมเวลาในท้องถิ่นคือค่าตรงวันที่เวลาแบบไม่มีตัวบ่งชี้ UTC และไม่มีการอ้างอิงถึงโซนเวลา ตัวอย่างเช่น ข้อความต่อไปนี้แสดงวันที่ 18 มกราคม 1998 เวลา 23:00: DTSTART:19980118T230000. ค่าตรงวันที่เวลาแบบนี้เรียกว่า "floating" และไม่ได้ผูกกับโซนเวลาใดเป็นพิเศษ ใช้เพื่อแสดงค่า ชั่วโมง นาที และวินาทีเดียวกันโดยไม่คำนึงถึงโซนเวลาที่กำลังถูกสังเกตอยู่.

DATE-TIME พร้อมเวลา UTC

วันที่ที่มีเวลา UTC หรือเวลาแน่นอน จะระบุด้วยอักษร Z ตัวพิมพ์ใหญ่ต่อท้ายค่าเวลา ซึ่งเป็นตัวบ่งชี้ UTC. ตัวอย่างเช่น, ค่าต่อไปนี้แสดงวันที่ 19 มกราคม 1998 เวลา 07:00 UTC: DTSTART:19980119T070000Z โปรดทราบว่า Aspose.iCalendar เพิกเฉยต่อส่วนต่อท้าย Z ของรูปแบบ UTC และถือว่าเวลานั้นเป็นเวลาในท้องถิ่น. มาตรฐาน RFC2445 ระบุว่าช่วงเวลาที่กำหนดในกฎ UNTIL ของรูปแบบการเกิดซ้ำต้องอยู่ในรูปแบบ UTC. คำกล่าวนี้ดูแปลก, และในความเป็นจริงมีตัวอย่างในมาตรฐานที่คำนวณผิด. Aspose.iCalendar ยอมรับเวลาหลายรูปแบบในกฎ UNTIL.

DATE-TIME พร้อมเวลาในพื้นที่และโซนเวลา

เพื่ออ้างอิงโซนเวลา, DATE-TIME จะถูกปรับด้วยคุณสมบัติ TZID. ตัวอย่างเช่น, ค่าต่อไปนี้แสดงเวลา 2 นาฬิกาเช้าในนิวยอร์กวันที่ 19 มกราคม 1998: DTSTART;TZID=US-Eastern:19980119T020000. โปรดทราบว่า Aspose.iCalendar ปัจจุบันละเลยพารามิเตอร์ TZID และถือว่าเวลาเป็นเวลาท้องถิ่น.

BYWEEKNO ให้การปฏิบัติตาม ISO 8601

ใช้ BYWEEKNO เฉพาะเมื่อต้องการปฏิบัติตาม ISO 8601 จำเป็นต้องใช้ ตัวเลขสัปดาห์ตามที่ ISO 8601 กำหนดจะแตกต่างอย่างมากจากตัวเลขสัปดาห์ในความหมายทั่วไป ตาม ISO 8601 สัปดาห์ที่หนึ่งของปีปฏิทินคือสัปดาห์แรกของปีที่มีอย่างน้อยสี่วัน กฎนี้ทำให้ขั้นตอนอัลกอริทึมเฉพาะสำหรับแอปพลิเคชันที่ต้องการปฏิบัติตาม ISO 8601 และทำให้เกือบจะไม่สามารถนำไปใช้กับการใช้อื่น ๆ ISO 8601 ได้รับการสนับสนุนโดยแอปพลิเคชันการธนาคารและการเงินของยุโรปบางส่วน และยังใช้ในโทรทัศน์สำหรับการจองโฆษณา กฎ BYWEEKNO กำหนดรายการตัวเลขคั่นด้วยเครื่องหมายจุลภาคที่ระบุสัปดาห์ของปี ค่าใช้ได้คือ 1 ถึง 53 และ 1 ถึง 53 ซึ่งสอดคล้องกับสัปดาห์ตามการนับสัปดาห์ที่กำหนดใน ISO 8601 BYWEEKNO ใช้ได้เฉพาะกับกฎ YEARLY เท่านั้น.

Net: การแยกไฟล์ข้อความ Microsoft Outlook

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

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

โหลดข้อความอีเมล.
รับหัวข้ออีเมล.
รับชื่อผู้ส่ง.
รับเนื้อความเต็มของข้อความ.
ตรวจสอบว่ามีไฟล์แนบหรือไม่.
รับชื่อไฟล์ของไฟล์แนบใด ๆ และบันทึกไว้.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีแยกไฟล์ข้อความ Microsoft Outlook.

Net: รับการแจ้งเตือนสำหรับข้อความที่ส่งสำเร็จและที่ล้มเหลว

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

เมื่อคุณต้องการรับการแจ้งเตือนการจัดส่งสำหรับข้อความที่ส่งสำเร็จและล้มเหลว คุณสามารถใช้ตัวดำเนินการ pipe (|) สำหรับ DeliveryNotificationOptions คุณสมบัติของ MailMessage คลาส ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีรับการแจ้งเตือนสำหรับข้อความที่ส่งสำเร็จและล้มเหลว.

Net: การตรวจจับข้อความอีเมลใหม่บนเซิร์ฟเวอร์ POP3

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

ด้วยบัญชี POP3 คุณสามารถทิ้งข้อความบนเซิร์ฟเวอร์ขณะดาวน์โหลดและอ่านข้อความ การทิ้งอีเมลบนเซิร์ฟเวอร์หมายความว่ามันสามารถเข้าถึงได้โดยแอปพลิเคชันและบุคคลอื่น ๆ เช่น ผู้ใช้ที่เข้าถึงอีเมลจากหลายอุปกรณ์ หรือคุณอาจต้องการดาวน์โหลดเฉพาะข้อความที่ตรงตามเกณฑ์พิเศษ เช่น ข้อความที่มีหัวข้อเฉพาะ เพื่อจัดการอีเมล คุณสามารถ;

อ่านข้อความทั้งหมดจากเซิร์ฟเวอร์เมล POP3 โดยใช้ Aspose.Email.
ดาวน์โหลดข้อความไปยังฐานข้อมูลในเครื่องของคุณ.

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

การตรวจจับข้อความใหม่

เพื่อระบุอีเมลใหม่จากรายการอีเมลบนเซิร์ฟเวอร์ POP3:

เชื่อมต่อกับเซิร์ฟเวอร์.
รับรายการอีเมล.
เชื่อมต่อกับฐานข้อมูล.
รับรายการอีเมล.
เปรียบเทียบรายการ.
บันทึกอีเมลใหม่ลงฐานข้อมูล.

กระบวนการเร็วขึ้นเมื่อคุณ:

ดึงรหัสยูนิกทั้งหมดของข้อความเข้าสู่ตารางแฮช.
ค้นหาในตารางแฮชแทนฐานข้อมูลสำหรับแต่ละข้อความอีเมลในลูป foreach(…)

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

Net: การอ่านข้อความอีเมลจากไลบรารีเอกสาร Microsoft SharePoint

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

บทความนี้แสดงวิธีการอ่านข้อความอีเมลจากไลบรารีเอกสาร Microsoft SharePoint เพื่อเข้าถึงไฟล์ในไลบรารีเอกสาร SharePoint จำเป็นต้องติดตั้ง SharePoint SDK บนระบบ SDK จะให้ API ที่จำเป็นสำหรับการเข้าสู่ระบบและเข้าถึงไฟล์จากไลบรารีเอกสาร

การอ่านข้อความอีเมลจาก SharePoint

ตัวอย่างโค้ดด้านล่างสมมติว่าไฟล์ข้อความ Microsoft Outlook (.msg) ถูกเก็บไว้ในโฟลเดอร์ SharedDocument ของไลบรารีเอกสาร SharePoint SDK ของ SharePoint จะใช้เพื่อดึงไฟล์ข้อความเป็นสตรีมแล้วส่งสตรีมนั้นไปยังอินสแตนซ์ของ Aspose.Email’s MailMessage คลาส. คลาส MailMessage จะโหลดสตรีมและวิเคราะห์ไฟล์ข้อความ Outlook หลังจากนั้นให้เข้าถึงคุณสมบัติของคลาส MailMessage เช่น เรื่อง, เนื้อหาแบบข้อความ, เนื้อหา HTML ฯลฯ เพื่อใช้ข้อมูลในโปรเจกต์ Visual Studio สำหรับข้อมูลวิธีการติดตั้งและกำหนดค่า Microsoft SharePoint Server และ SDK โปรดดูส่วนที่เกี่ยวข้องในไลบรารี MSDN โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอ่านข้อความอีเมลจาก SharePoint

Net: การตั้งค่า Default Text Encoding ในข้อความอีเมล

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

บทความนี้แนะนำ MailMessage.PreferredTextEncoding คุณสมบัติและอธิบายวิธีการใช้งาน โดยใช้คุณสมบัตินี้คุณสามารถตั้งค่า default text encoding สำหรับคุณสมบัติดังต่อไปนี้:

จาก: ชื่อที่แสดง
ถึง: ชื่อที่แสดง
Subject
Body

ตั้งค่า Default Text Encoding

ในเวอร์ชันก่อนของ Aspose.Email การเข้ารหัสข้อความสำหรับคุณสมบัติ from, to, subject และ body ถูกตั้งค่าแยกกัน เพื่อเพิ่มความสะดวกใช้งาน เราได้เพิ่ม PreferredTextEncoding คุณสมบัติที่ตั้งค่าทั้งหมดพร้อมกัน ตอนนี้ง่ายขึ้นในการรับรองว่าเนื้อความทั้งหมดในคุณสมบัติดังกล่าวถูกเข้ารหัสอย่างถูกต้องในข้อความอีเมล โค้ดตัวอย่างต่อไปนี้แสดงวิธีใช้คำภาษาฝรั่งเศสเป็นชื่อแสดงสำหรับที่อยู่อีเมล, หัวเรื่องและเนื้อหา.

Net: การแปลงไฟล์ข้อความ Outlook (MSG) เป็นภาพ TIFF

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

ในบทความนี้ เราแสดงวิธีแปลงไฟล์ Outlook MSG เป็นภาพ TIFF

ขั้นแรก อ่านไฟล์ MSG และแปลงเป็นรูปแบบ MHTML ด้วย Aspose.Email สำหรับ .NET ใช้ Aspose.Email.MailMessage คลาสเพื่อโหลดไฟล์ข้อความ
หลังจากโหลดไฟล์แล้ว ให้เรียก MailMessage.Save() เมธอดและบันทึกเป็นสตรีมในรูปแบบ MHTML
ใช้ Aspose.Words สำหรับ .NET เพื่อแปลงสตรีม MHTML เป็น TIFF ใช้ Aspose.Words.Document คลาสเพื่อโหลดสตรีม MHTML
สุดท้าย ให้เรียก Document.Save() วิธีการบันทึกเอกสาร MHTML เป็น TIFF.

หากเอกสารมีหลายหน้า จะสร้างไฟล์ TIFF แบบหลายหน้า โค้ดตัวอย่างด้านล่างแสดงวิธีแปลงไฟล์ข้อความ Outlook (MSG) เป็นภาพ TIFF

Net: ใช้เอกสาร Microsoft Word เป็นเนื้อหาข้อความและส่งอีเมล

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

บทความนี้แสดงวิธีใช้เอกสาร Microsoft Word เป็นส่วนเนื้อหาอีเมลและส่งให้ผู้รับ ตัวอย่างเอกสารเป็นใบแจ้งหนี้การขายจากฐานข้อมูลตัวอย่าง Northwind ที่ส่งออกเป็นรูปแบบ Microsoft Word Aspose.Email สำหรับ .NET จัดการกับโปรโตคอลเครือข่ายและคุณลักษณะของ Microsoft Outlook และไม่สามารถจัดการเอกสาร Microsoft Word ได้ เพื่อแก้ไขปัญหานี้ ตัวอย่างในบทความนี้ใช้ Aspose.Words สำหรับ .NET เพื่อโหลดเอกสาร Word และแปลงเป็นรูปแบบ MHTML Aspose.Email สำหรับ .NET จะใช้เอกสาร MHTML นั้นเป็นส่วนเนื้อหาอีเมล

ใช้เอกสาร Microsoft Word เป็นเนื้อหาอีเมล

ตัวอย่างโค้ดด้านล่างแสดงวิธีการส่งเอกสาร Word เป็นส่วนเนื้อหาอีเมลโดยใช้ Aspose.Words สำหรับ .NET และ Aspose.Email สำหรับ .NET:

โหลดเอกสาร Microsoft Word โดยใช้ Aspose.Word ของ .NET Document คลาส.
บันทึกเป็นรูปแบบ MHTML.
โหลดเอกสาร MHTML โดยใช้ Aspose.Email ของ .NET MailMessage คลาสสำหรับตั้งค่าเนื้อหาอีเมล.
ตั้งค่าคุณสมบัติอื่นของข้อความโดยใช้ MailMessage คุณสมบัติและเมธอดของคลาส.
ส่งอีเมลโดยใช้ Aspose.Email ของ .NET SMTPClient คลาส.

เอกสารต้นทาง, ใบแจ้งหนี้การขายที่ส่งออกเป็น Microsoft Word จากตัวอย่าง Microsoft Northwind สามารถดูได้ด้านล่าง.

เมื่อข้อความถูกส่งและรับใน Microsoft Outlook จะปรากฏเหมือนข้อความด้านล่าง.

รูปแบบ HTML และภาพจะถูกคงไว้เช่นเดียวกับในเอกสารต้นฉบับเมื่อดูใน Outlook หรือไคลเอนต์อีเมลเว็บเช่น Gmail หรือ Hotmail ด้านล่างเป็นภาพหน้าจอของข้อความเมื่อเปิดด้วย Gmail บนเบราว์เซอร์ Chrome.

โค้ดส่วนต่อไปนี้จะแสดงวิธีใช้เอกสาร Microsoft Word เป็นเนื้อหาข้อความและส่งอีเมลโดยใช้ SmtpClient อินสแตนซ์ของคลาส.

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

// Load a Word document from disk and save it to stream as MHTML
Document wordDocument = new Document(folderPath + "invoice.docx");
MemoryStream mhtmlStream = new MemoryStream();
wordDocument.Save(mhtmlStream, SaveFormat.Mhtml);

// Load the MHTML in a MailMessage object
mhtmlStream.Position = 0;
using (MailMessage message = MailMessage.Load(mhtmlStream, new MhtmlLoadOptions()))
{
    message.Subject = "Sending Invoice by Email";
    message.From = "sender@gmail.com";
    message.To = "recipient@gmail.com";

    // Save the message in MSG format to disk
    message.Save(folderPath + "WordDocAsEmailBody_out.msg", SaveOptions.DefaultMsgUnicode);

    // Send the email message
    using (SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "sender@gmail.com", "password"))
    {
        client.SecurityOptions = SecurityOptions.SSLExplicit;
        client.Send(message);
    }
}

Net: คุณสมบัติการพิมพ์ของ Aspose.Email

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

คุณลักษณะการพิมพ์

นี้ Aspose.Email.Printing namespace ให้ชุดคุณสมบัติอันหลากหลายสำหรับการพิมพ์ข้อความเมลเป็นรูปแบบต่าง ๆ (XPS หรือ TIFF) และการกำหนดการจัดหน้า บทความนี้อธิบายรายละเอียด มีตัวเลือกหลายวิธีในการพิมพ์ข้อความอีเมลจาก Aspose.Email:

พิมพ์เฉพาะเนื้อหาข้อความ.
พิมพ์เนื้อหาข้อความและส่วนหัว.
พิมพ์เนื้อหา HTML.
ตั้งค่าการจัดหน้า.
ปรับขนาด TIFF ให้พอดีกับเครื่องพิมพ์โดยอัตโนมัติ.
ปรับ DPI เป้าหมายสำหรับ TIFF ที่ส่งออก.

พิมพ์เนื้อหาข้อความ

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

พิมพ์ส่วนหัวและเนื้อหาข้อความ

โค้ดสแนปต่อไปนี้แสดงวิธีการแสดงส่วนหัวและพิมพ์พร้อมกับเนื้อหาข้อความ, เปลี่ยน FormattingFlags เป็น MailInfo.

พิมพ์ข้อความพร้อมส่วน HTML

ข้อความที่มีเนื้อหา HTML ก็สามารถพิมพ์ได้ โค้ดสแนปต่อไปนี้แสดงวิธีการพิมพ์ข้อความที่มีส่วน HTML

ตั้งค่าการจัดหน้าสำหรับการพิมพ์

Aspose.Email.Printing.MailPrinter ให้การควบคุมสำหรับการตั้งค่าคุณสมบัติดังต่อไปนี้ของการจัดหน้า:

มีสองแฟล็ก: MailInfo และ None
หน่วยของหน้าสามารถเป็น Inch, Pixel, Point, Cm หรือ Millimeter.

โค้ดสแนปต่อไปนี้ใช้การตั้งค่าใด ๆ เพื่อแสดงวิธีการใช้คุณสมบัติเหล่านี้ ตั้งค่าหน้าให้สูง 20 ซม. และกว้าง 8 ซม. พร้อมขอบ 2 ซม.

ปรับขนาด TIFF ให้พอดีโดยอัตโนมัติ

Aspose.Email.Printing ให้ MessageFormattingFlags.AutoFitWidth คุณสมบัติที่ให้คุณปรับขนาด TIFF ให้พอดีกับเครื่องพิมพ์โดยอัตโนมัติ โค้ดสแนปต่อไปนี้แสดงวิธีใช้ Auto-fit.

ปรับ DPI เป้าหมายสำหรับ TIFF ที่ส่งออก

โค้ดสแนปต่อไปนี้แสดงวิธีใช้ DPI สำหรับ TIFF ที่ส่งออก.

Net: ใช้แผ่นงาน Microsoft Excel เป็นเนื้อความของข้อความและส่งอีเมล

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

บทความนี้ใช้ไฟล์ Microsoft Excel Workbook เป็นส่วนเนื้อหาของอีเมลและส่งให้ผู้รับ Aspose.Email สำหรับ .NET จัดการกับโปรโตคอลเครือข่ายและคุณลักษณะของ Microsoft Outlook และไม่สามารถจัดการไฟล์ Excel Workbook ได้ เพื่อลดข้อจำกัดนี้ ตัวอย่างในบทความใช้ Aspose.Cells สำหรับ .NET เพื่อโหลดไฟล์ Excel Workbook และแปลงเป็นสตรีม HTML แล้ว Aspose.Email สำหรับ .NET จะใช้สตรีม HTML นั้นเป็นส่วนเนื้อหาอีเมล ตัวอย่างโค้ดแสดงวิธีการส่งแผ่นงาน Excel เป็นส่วนเนื้อหาอีเมลโดยใช้ Aspose.Cells สำหรับ .NET และ Aspose.Email สำหรับ .NET

การโหลดไฟล์ Microsoft Excel Workbook ด้วยคลาส Workbook ของ Aspose.Cells
บันทึกเวิร์กบุ๊กที่โหลดไว้ไปยัง MemoryStream ในรูปแบบ HTML
ดึง HTML จากสตรีมเป็น String
กำหนดวัตถุ MailMessage ใหม่และตั้งค่า HtmlBody ให้เป็นเนื้อหา HTML จากขั้นตอนที่ 3
ส่งอีเมลโดยใช้คลาส SmtpClient ของ Aspose.Email สำหรับ .NET

ไฟล์ Excel แหล่งที่มาสามารถมองเห็นได้ดังต่อไปนี้:

เมื่อข้อความถูกส่งและรับใน Microsoft Outlook จะมีลักษณะเช่นข้อความด้านล่าง:

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการส่งแผ่นงาน MS Excel เป็นเนื้อความของข้อความและส่งอีเมล

Net: คลาสห่อหุ้มสำหรับโหลดข้อความอีเมลแบบอะซิงโครนัสโดยใช้ Aspose.Email

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

คลาสห่อหุ้มสำหรับโหลดข้อความอีเมล

มีหลายกรณีที่ต้องการฟังก์ชันการหมดเวลา (Timeout) เพื่อยกเลิกการกระทำที่ใช้เวลานานเกินความจำเป็น. บทความนี้นำเสนอคลาสตัวอย่างเพื่อให้ฟังก์ชันการหมดเวลาขณะโหลดไฟล์ EML/MSG ที่อาจทำให้เกิดการหน่วงเวลานานหรือไม่สามารถโหลดได้. เนื่องจากการหมดเวลาไม่ได้เกี่ยวข้องโดยตรงกับการอ่าน/เขียนบนดิสก์หรือเครือข่าย, การเพิ่มคุณลักษณะนี้ใน API มีประโยชน์น้อยเมื่อเทียบกับการทำในระดับผู้ใช้โดยการเขียนคลาสห่อหุ้มรอบ Aspose.

การยกเลิกเธรดที่ทำงานนานสามารถทำได้โดยใช้ delegate ที่ห่อหุ้มซึ่งส่งเธรดที่จะถูกฆ่าออกไปในตัวแปรภายในเมธอดที่เรียกใช้. เธรดที่ทำงานนานจะถูกยกเลิกโดยการ abort และการควบคุมจะกลับไปยังแอปพลิเคชันหลัก. ตัวอย่างโค้ดต่อไปนี้ให้คลาสห่อหุ้มตัวอย่างรอบไลบรารี Aspose.Email. โค้ดยังแสดงการใช้คลาสห่อหุ้มเป็นตัวอย่าง.

ตัวอย่างโปรแกรมด้วย .NET 3.5 ขึ้นไป

ตัวอย่างโปรแกรมด้วย .NET 2.0

ตัวอย่างการใช้งาน

Net: สร้างเหตุการณ์ที่เกิดจากรูปแบบการทำซ้ำ

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

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

คำนวณการเกิดขึ้นครั้งถัดไปหรือ n การเกิดขึ้นต่อไป

เพื่อรับการเกิดขึ้น "ถัดไป" ให้ใช้เมธอด GenerateOccurrences พร้อมพารามิเตอร์ nNextOccurrences=1 โค้ดตัวอย่างต่อไปนี้แสดงวิธีการสร้าง 20 การเกิดขึ้นโดยใช้ nNextOccurrences = 20 ผลลัพธ์ของโค้ดด้านล่างเป็นดังนี้:

รับข้อความที่เป็นมิตรต่อผู้ใช้สำหรับการทำซ้ำ

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

Net: เข้าถึงบริการเมลด้วย OAuth

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

ได้เพิ่มการสนับสนุน OAuth 2.0 ให้กับ Aspose.Email และสามารถใช้เข้าถึงเซิร์ฟเวอร์ SMTP, POP3, IMAP และ EWS โดยทั่วไป เซิร์ฟเวอร์ทั้งหมดที่สนับสนุนโทเค็น Bearer OAuth 2.0 สามารถใช้กับ Aspose.Email ได้ แต่ไคลเอนต์อีเมลของเราถูกทดสอบกับเซิร์ฟเวอร์อีเมลของ Google และเซิร์ฟเวอร์ Microsoft Office 365 การเข้าถึงเซิร์ฟเวอร์จาก SmtpClient, Pop3Client, ImapClient และ EWSClient ด้วย OAuth สามารถนำไปใช้ได้ 2 วิธี

ให้โทเค็นการเข้าถึงโดยตรงในคอนสตรัคเตอร์ของไคลเอนต์อีเมล ในกรณีนี้ผู้ใช้ต้องเข้าใจว่าช่วงอายุของโทเค็นการเข้าถึงมีจำกัด เมื่อโทเค็นหมดอายุ ไคลเอนต์อีเมลไม่สามารถใช้เข้าถึงเซิร์ฟเวอร์ได้
จัดเตรียมการนำเสนอผู้ให้โทเค็นแบบกำหนดเองโดยอิงจาก ITokenProvider อินเทอร์เฟซเข้าสู่คอนสตรัคเตอร์ของไคลเอนต์อีเมล ในกรณีนี้ไคลเอนต์จะตรวจสอบเวลาหมดอายุของโทเค็นและร้องขอ ITokenProvider สำหรับโทเค็นการเข้าถึงใหม่เมื่อโทเค็นก่อนหน้าหมดอายุ ด้วยวิธีนี้ไคลเอนต์จะรีเฟรชโทเค็นเป็นระยะและอาจทำงานกับเซิร์ฟเวอร์ได้ไม่จำกัดเวลา บริการส่วนใหญ่สนับสนุนวิธีง่ายๆ ในการรีเฟรชโทเค็นการเข้าถึง ตัวอย่างเช่น การใช้รีเฟรชโทเค็นในบริการของ Google หรือกระบวนการตรวจสอบสิทธิ์ ROPC ใน Microsoft identity platform สามารถใช้สำหรับการนำผู้ให้โทเค็นไปใช้ได้

กำหนดค่าบัญชีบนเซิร์ฟเวอร์ที่เหมาะสม

บทความต่อไปนี้ช่วยคุณกำหนดค่าบัญชีเพื่อเข้าถึงบริการอีเมล

สำหรับ Office 365
สำหรับ Gmail

เข้าถึงบริการอีเมลด้วยโทเค็นการเข้าถึง

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

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    "accessToken",
    true,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.Auto))
{

}

เข้าถึงบริการอีเมลด้วยผู้ให้โทเค็น

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเชื่อมต่อบริการอีเมลด้วยผู้ให้โทเค็น

ITokenProvider tokenProvider = TokenProvider.Google.GetInstance(
    "ClientId",
    "ClientSecret",
    "RefreshToken");

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

การนำเสนอ Custom ITokenProvider สำหรับ Office 365

คุณสามารถใช้การนำเสนอผู้ให้โทเค็นด้านล่างเพื่อเข้าถึงบริการอีเมลของ Office 365 ได้

using JsonConvert = Newtonsoft.Json.JsonConvert;
using Aspose.Email.Clients;
using Aspose.Email.Common.Utils;
using Aspose.Email.Tests.TestUtils;
using Newtonsoft.Json;
using System;
using System.IO;
using System.Net;
using System.Text;

namespace TestNS
{
    /// <summary>
    /// Azure resource owner password credential (ROPC) token provider
    /// https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
    /// https://portal.azure.com
    /// https://developer.microsoft.com/en-us/graph/graph-explorer/#
    /// token parser https://jwt.io
    /// </summary>
    internal class AzureROPCTokenProvider : ITokenProvider
    {
        private const string uriFormat = "https://login.microsoftonline.com/{0}/oauth2/v2.0/token";
        private const string bodyFormat =
            "client_id={0}" +
            "&scope={1}" +
            "&username={2}" +
            "&password={3}" +
            "&grant_type={4}";

        private readonly string scope;
        private const string grant_type = "password";
        private readonly object tokenSyncObj = new object();
        private OAuthToken token;
        private readonly string tenant;
        private readonly string clientId;
        private readonly string clientSecret;
        private readonly string userName;
        private readonly string password;

        /// <summary>
        /// Initializes a new instance of the <see cref="AzureROPCTokenProvider"/> class
        /// </summary>
        /// <param name="tenant"></param>
        /// <param name="clientId"></param>
        /// <param name="clientSecret"></param>
        /// <param name="scope"></param>
        /// <param name="userName"></param>
        /// <param name="password"></param>
        /// <param name="scopeAr"></param>
        public AzureROPCTokenProvider(
            string tenant, 
            string clientId, 
            string clientSecret, 
            string userName, 
            string password,
            string[] scopeAr)
        {
            this.tenant = tenant;
            this.clientId = clientId;
            this.clientSecret = clientSecret;
            this.userName = userName;
            this.password = password;
            this.scope = string.Join(" ", scopeAr);
        }

        /// <summary>
        /// Gets oAuth access token. 
        /// </summary>
        /// <param name="ignoreExistingToken">
        /// If ignoreExistingToken is true, requests new token from a server. Otherwise behaviour is depended on whether token exists or not.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </param>
        /// <returns>Returns oAuth access token</returns>
        public virtual OAuthToken GetAccessToken(bool ignoreExistingToken)
        {
            lock (tokenSyncObj)
            {
                if (this.token != null && !this.token.Expired && !ignoreExistingToken)
                    return this.token;
                token = null;
                string uri = string.Format(uriFormat, string.IsNullOrWhiteSpace(tenant) ? "common" : tenant);
                HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri);
                string body = string.Format(bodyFormat,
                    HttpUtility.UrlEncode(clientId),
                    HttpUtility.UrlEncode(scope),
                    HttpUtility.UrlEncode(userName),
                    HttpUtility.UrlEncode(password),
                    HttpUtility.UrlEncode(grant_type));
                byte[] bytes = Encoding.ASCII.GetBytes(body);
                request.Method = "POST";
                request.ContentType = "application/x-www-form-urlencoded";
                request.ContentLength = bytes.Length;
                MemoryStream ms = new MemoryStream(bytes);
                using (Stream requestStream = request.GetRequestStream())
                    requestStream.Write(bytes, 0, bytes.Length);
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                StringBuilder responseText = new StringBuilder();
                bytes = new byte[1024];
                int read = 0;
                using (Stream stream = response.GetResponseStream())
                {
                    while ((read = stream.Read(bytes, 0, bytes.Length)) > 0)
                        responseText.Append(Encoding.ASCII.GetString(bytes, 0, read));
                }
                string jsonString = responseText.ToString();
                AzureTokenResponse t = JsonConvert.DeserializeObject<AzureTokenResponse>(jsonString);
                token = new OAuthToken(
                    t.access_token,
                    TokenType.AccessToken,
                    DateTime.Now.AddSeconds(t.expires_in));
                return token;
            }
        }

        /// <summary>
        /// Gets oAuth access token.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </summary>
        /// <returns>Returns oAuth access token</returns>
        public OAuthToken GetAccessToken()
        {
            return GetAccessToken(false);
        }

        /// <summary>
        /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
        /// </summary>
        public virtual void Dispose()
        {
        }
    }

    /// <summary>
    /// A success response contains a JSON OAuth 2.0 response with the following parameters.
    /// </summary>
    public class AzureTokenResponse
    {
        /// <summary>
        /// The requested access token. The calling web service can use this token to authenticate to the receiving web service.
        /// </summary>
        public string access_token { get; set; }

        /// <summary>
        /// Indicates the token type value. The only type that Azure AD supports is Bearer For more information about bearer tokens, 
        /// see The OAuth 2.0 Authorization Framework: Bearer Token Usage (RFC 6750).
        /// </summary>
        public string token_type { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int expires_in { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int ext_expires_in { get; set; }

        /// <summary>
        /// The time when the access token expires. 
        /// The date is represented as the number of seconds from 1970-01-01T00:00:00Z UTC until the expiration time.
        /// This value is used to determine the lifetime of cached tokens.
        /// </summary>
        public int expires_on { get; set; }

        /// <summary>
        /// The App ID URI of the receiving web service.
        /// </summary>
        public string resource { get; set; }

        /// <summary>
        /// If an access token was returned, this parameter lists the scopes the access token is valid for.
        /// </summary>
        public string scope { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included the openid scope.
        /// </summary>
        public string id_token { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included offline_access.
        /// </summary>
        public string refresh_token { get; set; }
    }
}

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเชื่อมต่อบริการ Office 365 ด้วยผู้ให้โทเค็นแบบกำหนดเอง

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
    "Tenant",
    "ClientId",
    "ClientSecret",
    "EMail",
    "Password",
    scopes);

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.office365.com",
    587,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
    "outlook.office365.com",
    993,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "outlook.office365.com",
   995,
   "Test1@test.onmicrosoft.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

// Connecting to EWS server
const string mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
using (IEWSClient ewsClient = EWSClient.GetEWSClient(mailboxUri, credentials))
{

}

Net: การแยกแยะระหว่างไฟล์แนบแบบ Inline และแบบปกติ

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

เป็นสถานการณ์ทั่วไปที่ข้อความอีเมลอาจมีภาพ inline อยู่ในเนื้อหาและไฟล์แนบแบบปกติที่เกี่ยวข้อง การใช้ MailMessage คลาส, ไฟล์แนบแบบ inline สามารถดึงออกจาก LinkedResourceCollection คลาส, ในขณะที่ไฟล์แนบแบบปกติสามารถเข้าถึง/ดึงออกได้ด้วย AttachmentCollection คลาสของข้อความ อย่างไรก็ตาม สิ่งนี้จะแตกต่างเมื่อข้อความถูกโหลดด้วยคลาส Aspose.Email.Mapi.MapiMessage เนื่องจากภาพ inline และไฟล์แนบแบบปกติทั้งหมดสามารถเข้าถึงได้ในคลาส MapiAttachmentCollection เดียวกัน ดังนั้นจึงต้องพัฒนาเมธอดที่สามารถแยกแยะระหว่างไฟล์แนบแบบ inline และแบบปกติเมื่อใช้ MapiMessage

การใช้ Aspose.Email เพื่อแยกแยะไฟล์แนบแบบ Inline และแบบปกติ

บทความนี้อธิบายวิธีการแยกแยะไฟล์แนบแบบ inline จากไฟล์แนบแบบปกติโดยใช้ MapiMessage เพื่อกำหนดการแยกแยะนี้ จะพิจารณาประเภทของเนื้อหาใน MapiMessage ตามด้านล่าง:

Plain Text Body: ข้อความอีเมลที่มีประเภทเนื้อหาเป็น plain text ไม่จำเป็นต้องตรวจสอบ เนื่องจากไฟล์แนบทั้งหมดในข้อความดังกล่าวจะเป็นไฟล์แนบแบบปกติเสมอ

Html Body: ในกรณีที่ข้อความมีประเภทเนื้อหา HTML ไฟล์แนบควรมีคุณสมบัติ PR_ATTACH_FLAGS (0x37140003) และค่าของมันควรเท่ากับ 0x00000004 สำหรับไฟล์แนบแบบ inline หากเงื่อนไขนี้เป็นจริง จะพิจารณาตามแท็ก PR_ATTACH_CONTENT_LOCATION และ PR_ATTACH_CONTENT_ID เพื่อกำหนดลักษณะของไฟล์แนบ อย่างไรก็ตาม หากไม่มีแท็ก PR_ATTACH_FLAGS ของ Mapi ไฟล์แนบจะตรวจสอบคุณสมบัติ PR_ATTACH_DISPOSITION (0x3716001F หรือ 0x3716001E) เพื่อกำหนดประเภทไฟล์แนบ

Rtf Body: หากเนื้อหาเป็น RTF แล้วไฟล์แนบ OLE ทั้งหมดจะเป็นไฟล์แนบแบบ inline ค่า PR_ATTACH_METHOD สำหรับไฟล์แนบ OLE ทั้งหมดคือ 0x00000006.

ตัวอย่างโค้ดต่อไปนี้แสดงการแยกแยะระหว่างไฟล์แนบแบบ inline และแบบปกติโดยโปรแกรม ฟังก์ชัน IsInlineAttachment รับไฟล์แนบและประเภทของเนื้อความข้อความเป็นพารามิเตอร์เข้ามา และคืนค่า true หากไฟล์แนบเป็นแบบ Inline

Net: ส่งเมลโดยใช้ DNS

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

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

Net: การสกัดข้อมูลวัตถุที่ฝังอยู่

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

บางครั้งข้อมูล OLE ฝังมักจะแสดงเป็นไฟล์แนบ "oleData.mso" โดย MapiAttachment และต้องถูกแยกออกด้วยตนเอง ไฟล์ oleData.mso เหล่านี้เป็นรูปแบบ Microsoft Computer Document File (MCDF) และการสนับสนุนไฟล์เหล่านี้เกินขอบเขตของ Aspose.Email อย่างไรก็ตาม Aspose.Email สามารถใช้ร่วมกับไลบรารีโอเพ่นซอร์สอื่น ๆ เช่น OpenMCDF เพื่ออ่านเนื้อหาของไฟล์เหล่านี้และบันทึกลงดิสก์ Aspose.Email มีให้ InlineAttachmentExtractor คลาสสำหรับenumerate แพ็กเกจ MSO จากข้อมูลไบต์ของ oledata.mso ซึ่งสามารถใช้สกัดเนื้อหาโดยไลบรารีการอ่าน Compound Files.

หากประเภทของส่วนข้อความเป็น HTML (ไม่ใช่ RTF) และมีวัตถุ OLE ในข้อความ คุณสมบัติ MapiPropertyTag.PR_ATTACH_DATA_OBJ จะไม่มีอยู่ ในกรณีนี้ข้อมูลเกี่ยวกับวัตถุ OLE จะอยู่ในไฟล์ oldedata.mso.

การสกัดวัตถุที่ฝังอยู่

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

นับจำนวนแพ็คเกจ MSO จากข้อมูลไบนารีของไฟล์แนบ oledata.mso
สำหรับข้อมูล OLE แต่ละชุด, อ่าน CompoundFile
อ่านสตรีมด้วย CONTENTS
บันทึกเนื้อหาไปยัง FileStream

Net: บันทึกอีเมลเป็น PDF

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

บทความนี้แสดงวิธีการแปลงข้อความอีเมลเป็น PDF ด้วย Aspose.Email Aspose.Email สำหรับ .NET จัดการกับโปรโตคอลเครือข่ายและคุณลักษณะของ Microsoft Outlook และไม่สามารถทำการแปลงโดยตรงเป็น PDF ได้ เพื่อแก้ไขปัญหา ตัวอย่างในบทความนี้ใช้ Aspose.Email เพื่อแปลงข้อความอีเมลเป็นสตรีม MHTML แล้วใช้ Aspose.Words สำหรับ .NET เพื่อโหลดสตรีม MHTML นั้นและบันทึกเป็น PDF ข้อความอีเมลอาจมีไฟล์แนบด้วย เนื่องจากแต่ละไฟล์แนบอาจเป็นสื่อประเภทต่างกัน Aspose.Email จะละเลยไฟล์แนบเหล่านั้นขณะแปลงเป็น MHTML กล่าวคือ จะรวมเฉพาะภาพ inline ในข้อความเป็นส่วนของ MHTML ส่วนไฟล์แนบแบบปกติจะถูกละเลย

การแปลงข้อความอีเมลเป็น PDF

โค้ดต่อไปนี้แสดงการแปลงข้อความอีเมลเป็น PDF ด้วย Aspose.Email ร่วมกับ Aspose.Words สำหรับ .NET ซึ่งประกอบด้วยขั้นตอนต่อไปนี้:

โหลดข้อความอีเมลโดยใช้ MailMessage
บันทึกข้อความอีเมลไปยัง MemoryStream เป็น MHTML
โหลดสตรีมโดยใช้ Aspose.Words
บันทึกข้อความเป็น PDF

ข้อมูลอีเมลต้นฉบับสามารถดูได้ดังต่อไปนี้:

PDF ที่แปลงแล้วแสดงในรูปภาพต่อไปนี้:

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

string dataDir = RunExamples.GetDataDir_KnowledgeBase();
MailMessage mailMsg = MailMessage.Load(dataDir + "message3.msg");
MemoryStream ms = new MemoryStream();
mailMsg.Save(ms, Aspose.Email.SaveOptions.DefaultMhtml);

// create an instance of LoadOptions and set the LoadFormat to Mhtml
var loadOptions = new Aspose.Words.Loading.LoadOptions();
loadOptions.LoadFormat = LoadFormat.Mhtml;

// create an instance of Document and load the MTHML from MemoryStream
var document = new Aspose.Words.Document(ms, loadOptions);

// create an instance of HtmlSaveOptions and set the SaveFormat to Html
var saveOptions = new Aspose.Words.Saving.PdfSaveOptions();
document.Save(dataDir + "SaveEmailAsPDF_out.pdf", saveOptions);

Net: การส่งคำขอการประชุมพร้อมการเกิดซ้ำ

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

ด้วย Aspose.Email สามารถสร้างคำขอการประชุมพร้อมการเกิดซ้ำได้ บทความนี้อธิบายวิธีสร้างคำขอการประชุมที่มีการเกิดซ้ำเฉพาะ รหัสยูนิกของการนัดหมายสามารถบันทึกไว้เพื่อใช้ในภายหลังสำหรับส่งการอัปเดตใด ๆ ไปยังการนัดหมาย

สร้างคำขอประชุมพร้อมการทำซ้ำ

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

ส่งคำขออัปเดตนัดหมาย

สำหรับการส่งการอัปเดตสำหรับการนัดหมายก่อนหน้า จำเป็นต้องใช้รหัสยูนิก (unique id) ตัวอย่างโค้ดต่อไปนี้แสดงวิธีส่งคำขออัปเดตการนัดหมายนี้

Net: การสนับสนุนหลายเธรดในไคลเอนต์อีเมล

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

ไคลเอนต์เมลเช่น ImapClient และ Pop3Client อนุญาตให้ผู้ใช้ใช้ในสภาพแวดล้อมหลายเธรด ไคลเอนต์เมลสามารถมีการเชื่อมต่อหนึ่งหรือหลายการเชื่อมต่อกับเซิร์ฟเวอร์ เพื่อจัดการชุดการเชื่อมต่อภายในไคลเอนต์ จะใช้การจัดสระการเชื่อมต่อ (connection pool) จำนวนการเชื่อมต่อที่สามารถสร้างและใช้พร้อมกันได้ถูกจำกัดโดยคุณสมบัติ CredentialsByHostClient.MaxConnectionsPerServer คุณสมบัตินี้อาจตั้งค่าเป็น 1 หรือค่ามากกว่า โดยค่าเริ่มต้นคือ 10 คิวคำสั่งได้ถูกนำมาใช้สำหรับการเชื่อมต่อเพื่อรองรับการทำงานหลายเธรด คำสั่งจะดำเนินการตามขั้นตอนที่ง่ายที่สุดที่กำหนดในโปรโตคอล เช่น Noop, Authenticate เป็นต้น ผู้ใช้สามารถเริ่มดำเนินการคำสั่งจำนวนมากกว่าการเชื่อมต่อที่มีได้ แต่คำสั่งจะทำงานก็ต่อเมื่อไคลเอนต์สามารถสร้างการเชื่อมต่อสำหรับดำเนินการนั้น

วิธีการใช้ไคลเอนต์เมลในสภาพแวดล้อมหลายเธรด

ไคลเอนต์อีเมลมีพฤติกรรมต่อไปนี้:

1. ในกรณีที่ MaxConnectionsPerServer = 1 ไคลเอนต์จะสร้างการเชื่อมต่อ 1 ตัว ทำการยืนยันตัวตนและการให้สิทธิ์ การเชื่อมต่อนี้จะอยู่ในสถานะทำงานจนกว่าไคลเอนต์จะถูกทำลาย การดำเนินการทั้งหมดจากเธรดต่าง ๆ จะถูกส่งไปยังคิวคำสั่งเดียวที่อยู่ในการเชื่อมต่อหลัก

2. ในกรณีที่ MaxConnectionsPerServer > 1 ไคลเอนต์จะสร้างจำนวนการเชื่อมต่อที่ต้องการ ทำการยืนยันตัวตนและการให้สิทธิ์สำหรับแต่ละการเชื่อมต่อ การเชื่อมต่อหนึ่งจะถูกสงวนเป็นการเชื่อมต่อหลัก การเชื่อมต่อนี้จะคงอยู่ในสถานะทำงานจนกว่าไคลเอนต์จะถูกทำลาย การเชื่อมต่ออื่น ๆ จะถูกสร้างและทำลายตามความต้องการ จำนวนสูงสุดของการเชื่อมต่อเช่นนี้กำหนดโดยคุณสมบัติ MaxConnectionsPerServer กล่าวคือ หาก MaxConnectionsPerServer = 2 จะมีหนึ่งการเชื่อมต่อสงวนเป็นหลักและการเชื่อมต่อที่สองใช้เป็นเพิ่มเติมสำหรับการดำเนินการที่ทำในเธรดอื่น ๆ ตามลำดับ หาก MaxConnectionsPerServer = 3 จะมีการเชื่อมต่อแรกสงวนเป็นหลักและสองการเชื่อมต่ออื่นใช้เป็นเพิ่มเติมสำหรับการดำเนินการในเธรดอื่น หากมีคำขอการเชื่อมต่อจากเธรดใหม่และการเชื่อมต่อทั้งหมดถูกใช้ ไคลเอนต์จะรอจนจำนวนการเชื่อมต่อที่ใช้ลดลง นี่เป็นจุดสำคัญที่ทำให้เข้าใจว่าการทำลายการเชื่อมต่ออย่างถูกต้องมีความสำคัญเพียงใด

ตัวอย่าง

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

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

2. ผู้ใช้สามารถสร้างเธรดโดยใช้วัตถุต่าง ๆ เช่น Thread, ThreadPool, Task หรือวัตถุอื่น ๆ ที่ตั้งใจไว้สำหรับวัตถุประสงค์นี้ นอกจากนี้ผู้ใช้ยังสามารถใช้เธรดที่สร้างในโค้ดของบุคคลที่สาม โดยในระหว่างนี้ไคลเอนต์มีสองรูปแบบของพฤติกรรม

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

b. เมื่อผู้ใช้เรียกใช้เมธอดเพื่อสร้างการเชื่อมต่อใหม่สำหรับเธรดเพิ่มเติม เธรดนั้นจะถูกบล็อกจนกว่าค่าปริมาณโควต้าสำหรับการเชื่อมต่อใหม่จะถูกเปลี่ยนเพื่ออนุญาตการเชื่อมต่อใหม่ จากนั้นการเชื่อมต่อใหม่จะถูกสร้าง การเชื่อมต่อนี้จะถูกตั้งเป็นการเชื่อมต่อเริ่มต้นสำหรับทุกการดำเนินการในเธรดนี้ หลังจากที่การดำเนินการทั้งหมดในเธรดนี้เสร็จสิ้น การเชื่อมต่อต้องถูกทำลาย เพื่อสร้างการเชื่อมต่อใหม่ใช้เมธอด CredentialsByHostClient.CreateConnection เมธอดนี้จะคืนค่าอ็อบเจกต์ที่ 구현 IDisposable interface เพื่อปล่อยการเชื่อมต่อต้องเรียก Dispose การสร้างและการทำลายการเชื่อมต่อต้องดำเนินการภายในเธรดที่ทำการดำเนินการเมล หากพยายามสร้างการเชื่อมต่อใหม่ในเธรดที่สร้างไคลเอนต์เมล จะเกิดข้อผิดพลาด เนื่องจากเธรดนั้นในขณะนั้นไม่สามารถใช้สร้างการเชื่อมต่อใหม่ได้ นอกจากนี้การสร้างการเชื่อมต่อใหม่ไม่เป็นไปได้เมื่อ MaxConnectionsPerServer = 1 ตัวอย่างโค้ดการสร้างการเชื่อมต่อใหม่ในเธรดเพิ่มเติม:

คำแนะนำ

ควรสังเกตว่าหากผู้ใช้ส่งคำสั่งทั้งหมดไปยังการเชื่อมต่อหลัก อาจเกิดสถานการณ์ที่คำสั่งจากเธรดต่าง ๆ ปะปนกัน ผู้ใช้ควรเข้าใจว่าคำสั่งใดพึ่งพาลำดับของมันและต้องดำเนินการเพื่อซิงโครไนซ์คำสั่งเหล่านั้น นอกจากนี้ยังต้องพิจารณาความเป็นไปได้ของการดำเนินคำสั่งในเซสชันต่าง ๆ (IMAP/POP3) งานที่ใช้เวลามากที่สุด เช่น FetchMessage, AppendMessage และ Send อาจเหมาะกับการทำในเธรดใหม่และการเชื่อมต่อใหม่ แต่งานที่เร็วเช่น Delete ควรทำกับการเชื่อมต่อหลัก โปรดทราบว่าการเริ่มต้นการเชื่อมต่อใหม่เป็นงานที่กินเวลามากพอสมควร

Net: แนะนำและแอปพลิเคชันตัวอย่าง

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

กรณีการใช้งาน Aspose.Email.Mail

บทความนี้เสนอการใช้ที่เป็นไปได้หลายแบบสำหรับ Aspose.Email สำหรับ .NET, โดยเน้นเป็นพิเศษที่ฟีเจอร์การเขียนโปรแกรมอีเมลของคอมโพเนนท์.

ซอฟต์แวร์จดหมายข่าว

นี้ Aspose.Email.Mail API สามารถใช้สร้างแอปพลิเคชันจดหมายข่าวที่แข็งแกร่ง. ด้วยการสนับสนุนของ Aspose.Email ในการเพิ่มวัตถุฝัง (เช่น รูปภาพ, เสียง ฯลฯ), สามารถสร้างจดหมายข่าว HTML ที่สมบูรณ์พร้อมภาพ (และวัตถุฝังอื่น ๆ). ด้วยฟีเจอร์ส่งเมลจำนวนมากของ API Aspose.Email.Mail, ยังสามารถส่งอีเมลจำนวนมหาศาลในช่วงเวลาจำกัด. Aspose.Email.Mail ยังมีฟีเจอร์การรวมเมลแบบเทมเพลตที่สามารถใช้สร้างเทมเพลตจดหมายข่าว. เทมเพลตจดหมายข่าวสามารถใช้ทำการรวมเมลเพื่อส่งจดหมายข่าวแบบกลุ่ม. มีงานอื่น ๆ อีกมากที่ Aspose.Email.Mail สามารถทำในแอปพลิเคชันการตลาดอีเมล.

เครื่องมือการตลาดอื่น ๆ

เช่นเดียวกับแอปพลิเคชันจดหมายข่าว, ซอฟต์แวร์หลายประเภทอื่นๆ สามารถสร้างได้โดยใช้ Aspose.Email.Mail. ใช้เพื่อสร้างการตลาดอีเมล, โปรแกรมส่งเมลจำนวนมากและแคมเปญอีเมลแบบกลุ่ม, และอื่น ๆ อีกมาก.

แอปพลิเคชันธุรกิจ

Aspose.Email.Mail สามารถใช้ในแอปพลิเคชันธุรกิจเกือบทุกประเภทเพื่อดำเนินการงานอรรถประโยชน์:

การแจ้งเตือนอีเมล: ส่งการแจ้งเตือนอีเมลเพื่อบอกผู้ใช้เกี่ยวกับกิจกรรม
คำขอประชุม: ส่งคำขอประชุมธุรกิจโดยใช้การสนับสนุน iCalendar ของ Aspose.Email.Mail.
อีเมลรายงานตามกำหนดเวลา: รายงานเป็นส่วนสำคัญของแอปพลิเคชันธุรกิจส่วนใหญ่. รายงานหลายประเภทถูกสร้างตามช่วงเวลา. ใช้ Aspose.Email.Mail เพื่อส่งอีเมลรายงานตามกำหนดเวลา.

ไคลเอนต์อีเมล

Aspose.Email.Mail ยังสามารถใช้ในไคลเอนท์อีเมลเพื่อส่งอีเมลปกติได้. มันรองรับไฟล์แนบ, วัตถุฝัง, เหตุการณ์ iCalendar, การรวมเมล, การส่งอีเมลจำนวนมาก, เป็นต้น, ดังนั้น Aspose.Email.Mail เป็นตัวเลือกที่ดีที่สุดในการสร้างแอปพลิเคชันไคลเอนท์อีเมลแบบ Windows หรือแบบเว็บ.

แอปพลิเคชันตัวอย่าง Aspose.Email.Mail

เพื่ออธิบายวิธีใช้ Aspose.Email.Mail, เราจะสร้างแอปพลิเคชันชื่อ ‘My First Email’ ที่แสดงวิธีสร้างข้อความอีเมลด้วย คลาส MailMessage และจากนั้นส่งมันโดยใช้คลาส SmtpClient.

Mail : ขั้นตอนแอปพลิเคชันตัวอย่าง

กรุณาทำตามขั้นตอนด้านล่างเพื่อสร้างแอปพลิเคชัน ‘My First Mail’ โดยใช้ Aspose.Email.

เปิด Visual Studio.
ในเมนู File, เลือก New, แล้ว Project. (เลือกสร้างแอปพลิเคชัน Windows แบบ C# หรือ VB.NET).
หากคุณมีไลเซนส์, ให้ใช้ไลเซนส์เพื่อใช้เวอร์ชันเต็มของ Aspose.Email.
นำเข้า Aspose.Email DLL เข้าสู่แอปพลิเคชันโดยคลิกขวาที่ Reference ใน Solution Explorer.
ออกแบบแอปพลิเคชัน Windows ของคุณ: สร้างอินเทอร์เฟซที่รับข้อมูลสามช่อง: From, To และ Message.
คลิกสองครั้งที่ปุ่ม Send ในมุมมองออกแบบและเขียนโค้ดของคุณในตัวแก้ไข.
สร้างอ็อบเจกต์ของคลาส MailMessage และใช้คุณสมบัติของมันเพื่อสร้างข้อความอีเมล (อ็อบเจกต์ของคลาส MailMessage ใช้ในการสร้างข้อความอีเมลที่ส่งไปยังเซิร์ฟเวอร์ SMTP เพื่อการส่งมอบโดยใช้คลาส SmtpClient).
สร้างอ็อบเจกต์ของคลาสต SmtpClient และใช้คุณสมบัติของมันเพื่อส่งข้อความอีเมล.
ทดสอบแอปพลิเคชัน Windows ของคุณโดยกด F5.
พิมพ์ที่อยู่ในช่อง From และ To.
พิมพ์ข้อความในช่อง Message Body.
คลิก Send.

ขั้นตอนข้างต้นอธิบายด้านล่าง ให้คลิกสองครั้งที่ปุ่ม Send ในมุมมองออกแบบและเพิ่มโค้ดด้านล่าง:

เมื่อเชื่อมต่อกับเซิร์ฟเวอร์ที่เปิดใช้งาน SSL เราต้องตั้งค่าคุณสมบัติต่อไปนี้ของอ็อบเจกต์ SMTPClient

สรุป

Aspose.Email.Mail เป็นคอมโพเนนท์ที่มีพลังมากที่นักพัฒนาสามารถทำงานเกี่ยวกับอีเมลได้เกือบทั้งหมด, เช่น ส่งอีเมลจำนวนมากแบบหลายเธรด, ใช้การรวมเมล, เพิ่มไฟล์แนบ, ฝังรูปภาพและเสียงในข้อความอีเมล, เพิ่มเหตุการณ์ iCalendar ไปยังอีเมล, รับอีเมลและอื่น ๆ อีกมาก.

Aspose.Email.Pop3

Aspose.Email.Pop3 ทำการนำ Post Office Protocol v3 (POP3) ไปใช้บน .NET framework. ทำให้นักพัฒนา .NET สามารถเพิ่มคุณสมบัติการสอบถามและรับอีเมลในแอปพลิเคชันของพวกเขาโดยไม่ต้องเจาะลึกรายละเอียดของโปรโตคอลและความซับซ้อนของการเขียนโปรแกรมอีเมลและเครือข่าย. Aspose.Email.Pop3 สนับสนุนคำสั่งทั้งหมดที่กำหนดในมาตรฐานโปรโตคอล POP3, และให้ส่วนต่อประสานที่ใช้งานง่ายพร้อมโมเดลวัตถุที่กะทัดรัดและเข้าใจง่าย. มันลดเส้นโค้งการเรียนรู้ที่ทั่วไปสำหรับนักพัฒนา .NET อย่างมาก.

Pop3 : คุณสมบัติหลัก

เป็นส่วนหนึ่งของ Aspose.Email, Aspose.Email.Pop3 ถูกออกแบบเฉพาะสำหรับ .NET และเขียนด้วยโค้ด C# ที่จัดการ. มันให้คุณ:

เชื่อมต่อและเข้าสู่ระบบเซิร์ฟเวอร์ POP3.
รองรับ APOP.
สอบถามข้อความ.
ดึงข้อความ.
สนับสนุนรูปแบบการเขียนโปรแกรมแบบ Async อย่างเต็มที่
รองรับ SSL.

สถานการณ์การใช้ Aspose.Email.Pop3

Aspose.Email.Pop3 สามารถใช้โดยนักพัฒนาในหลายสถานการณ์. ที่นี่เราจะแบ่งปันบางกรณี.

การอัตโนมัติอีเมลธุรกิจ

Aspose.Email.Pop3 สามารถใช้สอบถามกล่องขาเข้าของอีเมลและดึงข้อความอีเมล. มันทำงานร่วมกับคอมโพเนนท์การส่งอีเมล Aspose.Email.Mail อย่างราบรื่น. Aspose.Email รองรับการทำงานอัตโนมัติของอีเมลอย่างเต็มที่. ส่งข้อความอีเมลด้วย Aspose.Email.Mail และดึงข้อความด้วย Aspose.Email.Pop3. ข้อความอีเมลที่ดาวน์โหลดแล้วสามารถประมวลผลต่อได้โดย Aspose.Email.Mime.

ไคลเอนต์อีเมล

Aspose.Email.Pop3 สามารถใช้ในแอปพลิเคชันไคลเอนท์อีเมลเพื่อรับอีเมล.

Pop3 : ตัวอย่างแอปพลิเคชัน

ที่นี่ เราจะสาธิตวิธีการใช้ Aspose.Email.Pop3. คลาสนี้มีหลายคุณสมบัติแต่เราจะมุ่งเน้นที่วิธีเชื่อมต่อกับเซิร์ฟเวอร์ POP3 และดึงข้อความ. ตัวอย่างแสดงวิธีสร้างแอปพลิเคชันใน Visual Studio พร้อมกับตัวอย่างโค้ดที่ทำให้แอปทำงาน. ทำตามขั้นตอนด้านล่างเพื่อสร้างแอปตัวอย่างโดยใช้ Aspose.Email.Pop3.

เปิด Visual Studio.
ในเมนู File, เลือก New แล้ว Project.
เลือกสร้างแอปพลิเคชัน Windows แบบ C# หรือ VB.NET.
นำเข้า Aspose.Email.dll ไปยังแอปพลิเคชันโดยคลิกขวาที่ Reference ใน Solution Explorer.
ตอนนี้ออกแบบแอปพลิเคชัน Windows ตามที่แสดงด้านล่าง.
สร้างอ็อบเจกต์ Pop3Client.
ตั้งค่าชื่อโฮสต์ POP3, ชื่อผู้ใช้และรหัสผ่านในอ็อบเจกต์นี้
เรียกฟังก์ชัน Connect() และ Login() ของ Pop3Client.
สร้างอินสแตนซ์ MailMessage และดึงอีเมลแรกในบัญชีของคุณเข้าไปโดยเรียกฟังก์ชัน FetchMessage(). นี้จะนำข้อความแรกจากบัญชีอีเมลของคุณเข้าสู่อินสแตนซ์ MailMessage.
ใช้คุณสมบัติ From, Subject และ HtmlBody ของอ็อบเจกต์ MailMessage เพื่อดูผู้ส่ง, หัวเรื่องและเนื้อหาของข้อความ

ขั้นตอนข้างต้นได้แสดงในตัวอย่างโค้ดต่อไปนี้. ใช้โค้ดต่อไปนี้หลังจากปุ่มใด ๆ หรือในเหตุการณ์ OnLoad ของฟอร์ม.

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

Aspose.Email.Imap

Aspose.Email.Imap นำ Internet Message Access Protocol (IMAP) ไปใช้บน .NET frameworks. Aspose.Email.Imap ทำให้นักพัฒนา .NET สามารถเพิ่มความสามารถ IMAP ให้กับแอปพลิเคชันของพวกเขาได้อย่างรวดเร็ว โดยไม่ต้องเข้าใจรายละเอียดของโปรโตคอล. คอมโพเนนท์นี้รองรับการดึงและอัพโหลดข้อความ, การตรวจสอบสถานะใหม่/อ่าน/ยังไม่ได้อ่านของข้อความ, เป็นต้น.

Imap : คุณสมบัติหลัก

Aspose.Email.Imap ให้คุณ:

ดึงข้อความอีเมล.
อัปโหลดข้อความอีเมล.
แสดงรายการข้อความอีเมลในโฟลเดอร์ต่าง ๆ.
ตรวจสอบสถานะของข้อความอีเมล.
ทำงานกับ MailMessage.
ทำงานร่วมกับการสนับสนุน SSL.

การใช้ Aspose.Email.Imap

Aspose.Email.Imap นำ Internet Message Access Protocol (IMAP) ไปใช้บน .NET frameworks. ด้วยมัน, นักพัฒนาสามารถสอบถามและจัดการอีเมลจากเซิร์ฟเวอร์ IMAP ได้อย่างง่ายดาย, รวมถึงสร้าง, ลบ หรือเปลี่ยนชื่อโฟลเดอร์อีเมล. ด้วย Aspose.Email.Imap, นักพัฒนาสามารถใช้ประโยชน์จากโปรโตคอล IMAP ผ่าน API ที่ใช้งานง่าย. พวกเขาสามารถเข้าถึงอีเมลจากคอมพิวเตอร์ใดก็ได้เนื่องจากอีเมลยังคงถูกเก็บบนเซิร์ฟเวอร์. ด้วย Aspose.Email.Imap, นักพัฒนาสามารถสร้างแอปพลิเคชันเว็บหรือเดสก์ท็อปที่รับและจัดการอีเมลจากเซิร์ฟเวอร์ IMAP. Aspose ได้นำโปรโตคอล IMAP ไปใช้ตามมาตรฐานการพิสูจน์ตัวตนบนอินเทอร์เน็ตและ RFC. ดังนั้น Aspose.Email.Imap เป็นการดำเนินการที่ปลอดภัยและมีฟีเจอร์ครบถ้วนของโปรโตคอล IMAP พร้อมโมเดลวัตถุและอินเทอร์เฟซที่เข้าใจง่าย.

Imap : แอปพลิเคชันตัวอย่าง

บทความนี้อธิบายวิธีการใช้ Aspose.Email.Imap. เราจะสร้างแอปพลิเคชันเล็ก ๆ ที่นับจำนวนข้อความอีเมลในบัญชี IMAP ของคุณ. ทำตามขั้นตอนด้านล่างเพื่อสร้างแอปพลิเคชันตัวอย่างโดยใช้ Aspose.Email.Imap.

เปิด Visual Studio.
ในเมนู File, เลือก New แล้ว Project.
เลือกสร้างแอปพลิเคชัน Windows แบบ C# หรือ VB.NET.
นำเข้า Aspose.Email.dll ไปยังแอปพลิเคชันนี้โดยคลิกขวาที่ Reference ใน Solution Explorer.
สร้างอินสแตนซ์ของ ImapClient โดยส่งชื่อเซิร์ฟเวอร์ IMAP, ชื่อผู้เข้าสู่ระบบและรหัสผ่าน
เรียกฟังก์ชัน Connect() ของอินสแตนซ์ ImapClient เพื่อเชื่อมต่อกับเซิร์ฟเวอร์.
เรียกฟังก์ชัน SelectFolder() ของอินสแตนซ์ ImapClient เพื่อเลือกโฟลเดอร์ที่ต้องการนับจำนวนข้อความ.
ตอนนี้เรียกคุณสมบัติ CurrentFolder.TotalMessageCount ของอินสแตนซ์ ImapClient เพื่อนับจำนวนข้อความอีเมล.

Imap : ตัวอย่างโค้ด

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

สำหรับเซิร์ฟเวอร์อีเมลที่เปิดใช้งาน SSL ให้ตั้งค่าคุณสมบัติดังต่อไปนี้ของอ็อบเจ็กต์ ImapClient:

Aspose.Email.Exchange

Aspose.Email.Exchange ช่วยให้นักพัฒนาจัดการอีเมลบน Microsoft Exchange Server โดยใช้คอมโพเนนท์นี้คุณสามารถเชื่อมต่อ, แสดงรายการข้อความและดาวน์โหลดอีเมลจากกล่องจดหมาย Exchange Server ได้โดยไม่ต้องเข้าใจรายละเอียดของโปรโตคอลพื้นฐาน คอมโพเนนท์นี้สนับสนุนการแสดงรายการข้อความ, การส่งอีเมล, การดาวน์โหลดข้อความและการบันทึกเป็นรูปแบบ eml หรือ msg ลงในดิสก์ของคุณ เป็นต้น

Exchange : คุณสมบัติหลัก

Aspose.Email.Exchange ให้คุณ:

เชื่อมต่อกับ Microsoft Exchange Server
แสดงรายการข้อความอีเมลในกล่องจดหมาย Exchange
แสดงรายการข้อความอีเมลจากโฟลเดอร์ต่าง ๆ เช่น Inbox, Sent, Deleted หรือ Drafts
ลบข้อความในโฟลเดอร์ใดก็ได้บน Exchange Server.

การใช้ Aspose.Email.Exchange

ด้วย Aspose.Email.Exchange, นักพัฒนาสามารถเข้าถึงกล่องเมลของ Exchange Server จากแอปพลิเคชัน .NET ของพวกเขาได้ มันให้ API ที่ใช้งานง่ายสำหรับการจัดการอีเมลบน Exchange Server นักพัฒนาสามารถสร้างแอปพลิเคชันคอนโซล, เดสก์ท็อป หรือเว็บที่จัดการอีเมลในกล่องเมลของ Exchange ได้.

Aspose.Email.Exchange ตัวอย่างแอปพลิเคชัน

บทความนี้แสดงวิธีการใช้ Aspose.Email.Exchange. เราสร้างแอปพลิเคชันเดสก์ท็อปง่าย ๆ ที่เชื่อมต่อกับกล่องจดหมาย Exchange Server ดึงรายการข้อความในโฟลเดอร์ Inbox และแสดงบนฟอร์ม Windows.

Exchange : ขั้นตอนแอปพลิเคชันตัวอย่าง

เปิด Microsoft Visual Studio.
สร้างโปรเจ็กต์ใหม่ (เลือกภาษาที่คุณต้องการ C# หรือ VB.NET).
เพิ่มการอ้างอิงไปยังไฟล์ Aspose.Email.dll ในโครงการของคุณโดยคลิกขวาที่โครงการและเลือก Add Reference จากเมนู.
ออกแบบฟอร์ม Windows เช่นตัวอย่างด้านล่าง:

เพื่อให้แอปพลิเคชันทำงานได้สำเร็จ คุณต้องมีข้อมูลรับรองที่ถูกต้องสำหรับการเข้าถึง Exchange Server ที่นี่ เราดึงข้อมูลรับรอง – URI ของ Exchange Server, ชื่อผู้ใช้, รหัสผ่านและโดเมน – จากแบบฟอร์ม Windows ตัวอย่างนี้เป็นพื้นฐานมาก ดังนั้นคุณสมบัติของข้อความ – หัวข้อ, ผู้ส่งและผู้รับ – จึงแสดงใน ListBox อย่างง่าย

Exchange : ตัวอย่างโค้ด

เพิ่มโค้ดต่อไปนี้ลงในตัวจัดการเหตุการณ์คลิกของปุ่ม List Messages.

Exchange : ผลลัพธ์

ภาพหน้าจอนี้แสดงข้อความที่ดึงจาก Exchange Server. เมธอด ListMessages() คืนข้อมูลพื้นฐานเช่น หัวเรื่อง, ผู้ส่ง, ผู้รับ และ ID ของข้อความ. เพื่อรับข้อความเต็ม, เรียกเมธอด ExchangeClient.SaveMessage(). (การใช้ ExchangeClient.SaveMessage() ได้อธิบายไว้ในบทความ บันทึกข้อความจากกล่องเมล Exchange Server ในรูปแบบ EML และ MSG.)

Aspose.Email.Mime

Multipurpose Internet Mail Extensions (MIME) คือมาตรฐานอินเทอร์เน็ตที่ขยายรูปแบบอีเมลเพื่อสนับสนุนข้อความในชุดอักขระที่ไม่ใช่ US-ASCII, ไฟล์แนบที่ไม่ใช่ข้อความ, เนื้อความหลายส่วน, และข้อมูลส่วนหัวในชุดอักขระที่ไม่ใช่ ASCII. Aspose.Email.Mime Implement โปรโตคอล MIME บนเฟรมเวิร์ก .NET ทำหน้าที่เหมือนตัวแปล เพราะสามารถอ่านอีเมลจากไฟล์ (.eml เป็นต้น) หรือจากหน่วยความจำ (string) จากนั้นทำการแยกไฟล์หรือสตริงอีเมลเป็นส่วนที่มีความหมาย หากคุณต้องการเข้าถึงไฟล์อีเมลโดยไม่ต้องเจาะลึกรายละเอียดของโปรโตคอล MIME, ตัวอย่างเช่นการดึงไฟล์แนบจากอีเมล, ใช้ Aspose.Email.Mime.

คุณสมบัติหลัก

Aspose.Email.Mime ทำงานได้อย่างสมบูรณ์กับ Aspose.Email.Pop3 และ Aspose.Email.Mail.

Aspose.Email.Pop3 ดึงข้อความอีเมลจากกล่องเมลที่ระบุ.
Aspose.Email.Mail ส่งข้อความอีเมลไปยังกล่องเมลที่ระบุ.
Aspose.Email.Mime เป็นจุดเชื่อมของสองข้างข้างต้นและทำการแยกข้อความอีเมล.

Net: การยกเลิกคำขอประชุมด้วย Calendar

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

คุณสามารถส่งคำขอยกเลิกประชุมด้วย Aspose.Email โดยใช้วัตถุคลาส Appointment ได้ คุณต้องมีข้อมูลคำขอประชุมดั้งเดิมเพื่อยกเลิก ตัวอย่างในบทความนี้ส่งคำขอประชุมก่อน แล้วบันทึกข้อมูลลงฐานข้อมูลและยกเลิกคำขอโดยอิงจาก ID ของข้อความ

การส่งคำขอประชุม

ก่อนที่เราจะสามารถ ยกเลิกคำขอประชุม, เราต้องส่งบางอย่างออกไป:

แรกเริ่มสร้างอ็อบเจกต์ประเภท SmtpClient สำหรับส่งข้อความ
เพื่อรวบรวมข้อมูลผู้เข้าร่วม, เราได้สร้างตารางข้อมูลเพื่อให้ผู้ใช้ใส่ชื่อและที่อยู่ของคนที่ควรส่งคำเชิญ.
หลังจากทำการวนลูป for-each บนคอลเลกชัน Rows ของกริด, ให้บันทึกข้อมูลผู้เข้าร่วมทั้งหมดในคอลเลกชัน MailAddressCollection.
สร้างอ็อบเจกต์ของคลาส MailMessage พร้อมคุณสมบัติที่จำเป็นเช่น From, To และ Subject
สร้างอ็อบเจกต์ประเภท Appointment และระบุข้อมูลสถานที่, เวลาเริ่ม, เวลาสิ้นสุด, ผู้จัดและผู้เข้าร่วม
บันทึกข้อมูลทั้งหมดลงในฐานข้อมูล SQL Server. งานที่เกี่ยวกับ DB ทำในเมธอด SaveIntoDB.

โค้ดส่วนนี่แสดงวิธีส่งคำขอประชุม

การยกเลิกคำขอประชุม

เพื่อยกเลิกคำขอประชุม, ก่อนอื่นให้ดึง ID ของข้อความอีเมล. เนื่องจากเราได้บันทึกข้อมูลนี้ในฐานข้อมูลสำหรับตัวอย่างนี้, เราจึงสามารถดึงกลับได้ง่าย. เราได้ใช้กริดเพื่อโหลดข้อความที่ส่งทั้งหมด. ภาพหน้าฟอร์มเป็นดังต่อไปนี้:

เลือกแถวที่ต้องการส่งคำขอยกเลิก.
คลิก Send Cancel Request เพื่อส่งคำขอ
โค้ดนี้ดึง ID จากแถวที่เลือกของกริดและสอบถามฐานข้อมูลเพื่อรับข้อมูลผู้เข้าร่วม, ข้อความและข้อมูลที่เกี่ยวข้องกับปฏิทิน.
สร้างอินสแตนซ์ของคลาส Calendar และ MailMessage คลาสที่ใช้ข้อมูลที่ดึงจากฐานข้อมูล.
ใช้เมธอด Appointment.CancelAppointment() เพื่อส่งคำขอยกเลิก.
ส่งอีเมลโดยใช้ SMTP.

โค้ดส่วนนี่แสดงวิธียกเลิกคำขอประชุม

Net: แอปพลิเคชันแรกกับ Aspose.Email.Outlook

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

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

ใน Visual Studio บนเมนู File เลือก New แล้วเลือก Project.
เลือกสร้างแอปพลิเคชัน Windows ในรูปแบบ C# หรือ VB.NET
นำเข้า Aspose.Email DLL เข้าสู่แอปพลิเคชันโดยคลิกขวาที่ Reference ใน Solution Explorer นี้จะเป็นแอปพลิเคชันบน Windows ที่จะแสดงข้อมูลที่อยู่ในไฟล์ข้อความเท่านั้น.
สร้างอินสแตนซ์ของ MapiMessage คลาสโดยระบุเส้นทางของไฟล์ข้อความ.
ใช้คุณสมบัติสาธารณะเพื่อแสดงหัวเรื่อง, ผู้ส่ง, ผู้รับและเนื้อหาบนคอนโทรลของ Windows.

การทำงานของขั้นตอนข้างต้นแสดงในโค้ดสแนปต่อไปนี้ ใช้โค้ดต่อไปนี้หลังปุ่ม Load Msg File หรือในอีเวนต์ OnLoad ของฟอร์ม

Net: การปรับโครงสร้าง Connection Pool

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

กับการเปิดตัว Aspose.Email 19.3, pool การเชื่อมต่อได้ถูกปรับโครงสร้างใหม่ ใหม่ EmailClient ได้แนะนำคลาสที่จะมาทดแทน CredentialsByHostClient คลาส. เมธอด EmailClient คลาสให้ ConnectionAsgmtMode คุณสมบัติที่กำหนดโหมดการจัดสรรการเชื่อมต่อในสภาพแวดล้อมหลายเธรด EmailClient.ConnectionAsgmtMode ถูกตั้งค่าด้วย ConnectionAsgmtType enumerable.

ประเภทการเชื่อมต่อ

มีประเภทการเชื่อมต่อต่อไปนี้สามประเภท:

การเชื่อมต่อหลัก: คือการเชื่อมต่อที่สร้างและทำลายพร้อมกับไคลเอนต์อีเมล ไม่สามารถสร้างหรือทำลายด้วยตนเองได้
การเชื่อมต่อค่าเริ่มต้น: ผู้ใช้สามารถสร้างการเชื่อมต่อค่าเริ่มต้นสำหรับเธรดด้วย CreateConnection เมธอด หากการเชื่อมต่อค่าเริ่มต้นมีอยู่ เมธอดทั้งหมดของไคลเอนต์อีเมลที่ทำงานในเธรดจะใช้การเชื่อมต่อนี้โดยอัตโนมัติ สามารถมีการเชื่อมต่อค่าเริ่มต้นได้เพียงหนึ่งต่อเธรด สามารถสร้างด้วยตนเองหรืออัตโนมัติ ขึ้นอยู่กับคุณสมบัติ EmailClient.ConnectionAsgmtMode การเชื่อมต่อเหล่านี้สามารถสร้างด้วยตนเองโดยใช้ EmailClient.CreateConnection(createAsDefaultConnection = true) เมธอด หากการเชื่อมต่อค่าเริ่มต้นไม่ได้ใช้ (ขึ้นอยู่กับโหมดการจัดสรรการเชื่อมต่อ) การเชื่อมต่อหลักจะถูกใช้โดยอัตโนมัติแทน
การเชื่อมต่ออิสระ: คือการเชื่อมต่อที่ไม่ได้เชื่อมโยงกับเธรด สามารถสร้างด้วยตนเองและต้องใช้เป็นพารามิเตอร์ของเมธอดอย่างชัดเจน การเชื่อมต่อเหล่านี้สามารถสร้างด้วยตนเองโดยใช้ EmailClient.CreateConnection() เมธอดหรือ EmailClient.CreateConnection(createAsDefaultConnection = false) เมธอด.

ประเภทการจัดสรรการเชื่อมต่อ

เพื่อกำหนดค่า EmailClient.ConnectionAsgmtMode คุณสมบัติ, ConnectionAsgmtType enumerable ถูกใช้ ประเภทการจัดสรรที่ให้โดย ConnectionAsgmtType ได้แสดงด้านล่าง

ConnectionAsgmtType.UseMainOrDefault โหมดนี้เป็นค่าเริ่มต้นในคลไคลเอนต์อีเมล คลไคลเอนต์อีเมลใช้การเชื่อมต่อหลักสำหรับทุกการทำงานจากหลายเธรดหากการเชื่อมต่อเริ่มต้นยังไม่ได้สร้าง หรือหากไม่ได้ส่งการเชื่อมต่อเป็นพารามิเตอร์เมธอดโดยชัดเจน การเชื่อมต่อหลักคือการเชื่อมต่อที่สร้างพร้อมกับคลไคลเอนต์อีเมล ผู้ใช้สามารถสร้างการเชื่อมต่อเริ่มต้นสำหรับเธรดด้วย CreateConnection เมธอด หากการเชื่อมต่อค่าเริ่มต้นสำหรับเธรดถูกสร้าง จะถูกใช้โดยอัตโนมัติสำหรับทุกเมธอดของไคลเอนต์อีเมลที่เรียกในเธรดนั้น หากการเชื่อมต่อค่าเริ่มต้นสำหรับเธรดไม่ได้สร้าง การเชื่อมต่อหลักจะถูกใช้สำหรับทุกเมธอดของไคลเอนต์อีเมลที่เรียกในเธรดนั้น ผู้ใช้ยังสามารถสร้างการเชื่อมต่อที่ไม่เชื่อมโยงกับเธรด (ไม่ใช่ค่าเริ่มต้น) ด้วย CreateConnection เมธอด หากผู้ใช้ต้องการใช้การเชื่อมต่ออื่น (ไม่ใช่หลักและไม่ใช่ค่าเริ่มต้น) ผู้ใช้ต้องส่งการเชื่อมต่อนั้นอย่างชัดเจนเป็นพารามิเตอร์ของเมธอดที่ต้องการใช้ ผู้ใช้สามารถสร้างการเชื่อมต่อเพิ่มเติมได้ตามจำนวน การเชื่อมต่อค่าเริ่มต้นสามารถมีได้เพียงหนึ่งต่อเธรดหนึ่ง โปรดทราบว่าการเชื่อมต่อค่าเริ่มต้นทำงานได้อย่างถูกต้องหากผู้ใช้ใช้วัตถุ Thread สำหรับการเขียนโปรแกรมแบบหลายงาน หากผู้ใช้ใช้ ConnectionPool หรือใช้วัตถุ Task สำหรับการเขียนโปรแกรมแบบหลายงานโหมดนี้อาจทำให้แอปพลิเคชันทำงานผิดพลาด เพื่อหลีกเลี่ยงปัญหานี้ผู้ใช้ต้องทำการกำจัดการเชื่อมต่อค่าเริ่มต้นด้วยตนเอง (หากใช้) เมื่อสิ้นสุดการทำงานของโค้ด
ConnectionAsgmtType.UseMain คลไคลเอนต์อีเมลใช้การเชื่อมต่อหลักสำหรับทุกการทำงานจากหลายเธรด การเชื่อมต่อหลักคือการเชื่อมต่อที่สร้างพร้อมกับคลไคลเอนต์อีเมล ผู้ใช้ไม่สามารถสร้างการเชื่อมต่อเริ่มต้นได้ ผู้ใช้สามารถสร้างการเชื่อมต่อที่ไม่ได้เชื่อมโยงกับเธรด (ไม่ใช่การเชื่อมต่อเริ่มต้น) ด้วย CreateConnection เมธอด หากผู้ใช้ต้องการใช้การเชื่อมต่ออื่น (ไม่ใช่หลักและไม่ใช่ค่าเริ่มต้น) ผู้ใช้ต้องส่งการเชื่อมต่อนั้นอย่างชัดเจนเป็นพารามิเตอร์ของเมธอดที่ต้องการใช้
ConnectionAsgmtType.UseDefault คลไคลเอนต์อีเมลใช้การเชื่อมต่อเริ่มต้นโดยอัตโนมัติสำหรับทุกการทำงานจากหลายเธรด ในโหมดนี้จะไม่ใช้การเชื่อมต่อหลัก หากการเชื่อมต่อเริ่มต้นยังไม่ได้สร้างสำหรับเธรดบางตัว (การเรียกเมธอดของคลไคลเอนต์อีเมลครั้งแรก) คลไคลเอนต์อีเมลจะสร้างการเชื่อมต่อเริ่มต้นโดยอัตโนมัติสำหรับเธรดนั้นก่อนดำเนินการแรก ผู้ใช้ไม่สามารถสร้างการเชื่อมต่อเริ่มต้นสำหรับเธรดที่มี CreateConnectionเมธอดเพราะพวกมันถูกสร้างอัตโนมัติ เมื่อการเชื่อมต่อค่าเริ่มต้นสำหรับเธรดถูกสร้างขึ้น จะถูกใช้โดยอัตโนมัติสำหรับทุกเมธอดของไคลเอนต์อีเมลที่เรียกใช้ในเธรดนั้น ผู้ใช้ยังสามารถสร้างการเชื่อมต่อที่ไม่เชื่อมโยงกับเธรด (ไม่ใช่การเชื่อมต่อค่าเริ่มต้น) ด้วย CreateConnectionเมธอด หากผู้ใช้ต้องการใช้การเชื่อมต่ออื่น (ไม่ใช่หลักและไม่ใช่ค่าเริ่มต้น) ผู้ใช้จะต้องส่งการเชื่อมต่อนั้นอย่างชัดเจนเป็นพารามิเตอร์ของเมธอดที่ต้องการใช้ ผู้ใช้สามารถสร้างการเชื่อมต่อได้เพิ่มเติมตามจำนวนที่ต้องการ การเชื่อมต่อค่าเริ่มต้นสามารถใช้ได้เพียงหนึ่งต่อหนึ่งเธรด โปรดทราบว่าการเชื่อมต่อค่าเริ่มต้นทำงานได้อย่างถูกต้องหากผู้ใช้ใช้วัตถุ Thread สำหรับการเขียนโปรแกรมแบบหลายงาน หากผู้ใช้ใช้ ConnectionPool หรือใช้วัตถุ Task สำหรับการเขียนโปรแกรมแบบหลายงานโหมดนี้อาจทำให้พฤติกรรมของแอปพลิเคชันผิดพลาด เพื่อหลีกเลี่ยงปัญหานี้ผู้ใช้ต้องทำการกำจัดการเชื่อมต่อค่าเริ่มต้นด้วยตนเองเมื่อสิ้นสุดการทำงานของโค้ด