Documentation – مقالات فنی

Net: چرا Aspose.Email

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

Net: مقایسه Aspose.Email.Mail با APIهای مایکروسافت

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

مقایسه Aspose Email Mail با APIهای مایکروسافت

System.Web.Mail صرف یک wrapper برای دو کتابخانه COM است: CDONTS.NewMail (در cdonts.dll) و CDO.Message (در cdosys.dll). شما همچنین باید آن‌ها را بر روی سرور خود نصب کنید. به‌صورت پیش‌فرض، cdonts.dll و cdosys.dll همراه با Windows NT/2000/XP/2003 نصب می‌شوند.

جزئیات SmtpMail

اگر به کلاس System.Web.Mail.SmtpMail وارد شوید، برخی رفتارهای عجیب را خواهید یافت:

این فقط سیستم‌عامل‌های Win32NT را پشتیبانی می‌کند، برای مثال Windows 2000، Windows 2003، Windows XP.
زمانی که کلاس SmtpMail یک پیام ایمیل ارسال می‌کند، نسخهٔ سیستم‌عامل را بررسی می‌کند. اگر نسخه ≤ 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
قابلیت‌های سازگاری
پشتیبانی از .NET 2.0	X	X	X
قابلیت‌های عمومی
وابستگی به CDO/CDONTS		X
کد کاملاً مدیریت‌شده	X		X
احراز هویت	X	X	X
آدرس فرستنده	X	X	X
آدرس دریافت‌کنندگان	X	X	X
بدنه HTML	X	X	X
بدنه متنی	X	X	X
Bcc/Cc	X	X	X
ارسال ضمیمه	X	X	X
تصویر پیوست‌شده	X		X
رمزگذاری بدنه (Unicode/ASCII)	X	X	X
رمزگذاری موضوع (Unicode/ASCII)	X		X
مدل برنامه‌نویسی همزمان	X		X
مدل برنامه‌نویسی ناهمزمان	X		X
ویژگی‌های منحصربه‌فرد
سربرگ نامه سفارشی	X
سربرگ اهمیت	X
سربرگ حساسیت	X
سربرگ X‑Mailer	X
پاسخ به	X
تاریخ ارسال	X
ادغام نامه بر پایه قالب	X
ادغام نامه از DataSet	X
ادغام نامه از DataTable	X
ادغام نامه از DataReader	X
ارسال انبوه با چندنخی	X
ارسال تقویم	X
ارسال درخواست جلسه	X
بارگیری از فرمت Msg مایکروسافت	X
بارگیری از فرمت Mht مایکروسافت	X
ذخیره به فرمت Mht مایکروسافت	X
ذخیره به فرمت Eml	X
بارگیری از فرمت Eml	X
بارگیری از فایل سازگار با RFC 822	X
قابلیت‌های تعامل
کار با Aspose.Email.Pop3	X
کار با Aspose.Email.Imap	X
کار با 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 عالی است اگر اتصال اینترنت اختصاصی داشته باشید یا ایمیل خود را از مکان‌های مختلف بررسی کنید.

نگه‌داشتن ایمیل روی سرور در مقابل حذف ایمیل از سرور

اگر از پروتکل POP3 استفاده می‌کنید و ایمیل خود را از چندین کامپیوتر می‌خوانید، می‌خواهید ایمیل‌ها را روی سرور بگذارید تا در هر زمان در دسترس باشند. اگر ایمیل‌ها را روی سرور نگه ندارید، تمام نامه‌های موجود در صندوق ورودی شما به کامپیوتری که در حال استفاده هستید دانلود می‌شود. اگر ایمیل خود را فقط از یک مکان می‌خوانید، نیازی به نگه‌داشتن ایمیل‌ها روی سرور ندارید. هنگام تنظیم برنامه ایمیل خود، دستورالعمل‌های مربوط به این گزینه را خواهید دید.

چرا به جای POP3 از IMAP استفاده کنیم و ایمیل‌ها را روی سرور بگذاریم؟ با 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. قطعه کد زیر نشان می‌دهد چگونه ویژگی‌های پیام را تنظیم کنید، مثلاً موضوع، گیرنده و بدنه:

IMAP

این مقاله نشان می‌دهد چگونه چندین فعالیت را بر روی یک سرور ایمیل فعال بر پایه SSL با استفاده از پروتکل IMAP انجام دهید:

به یک سرور ایمیل متصل شوید.
تعداد کل پیام‌ها در صندوق ورودی را دریافت کنید.
پیام‌ها را به‌صورت محلی ذخیره کنید.
یک پیام ایجاد کنید و آن را به یک پوشه اضافه کنید.

اتصال به سرور ایمیل

از Aspose.Email استفاده کنید ImapClient شیء کلاس برای اتصال به سرور ایمیل. آدرس، پورت، نام کاربری و رمز عبور سرور برای برقراری اتصال لازم است. Gmail از پورت 993 برای پروتکل IMAP استفاده می‌کند، قطعه کد زیر نشان می‌دهد چگونه با این پورت به Gmail متصل شوید.

انتخاب یک پوشه و دریافت کل تعداد پیام‌ها

بررسی پوشهٔ Inbox رایج‌ترین کار هنگام بررسی ایمیل است. با استفاده از Aspose.Email، این کار فقط با دو خط ساده کد انجام می‌شود. قطعه کد زیر نشان می‌دهد چگونه به پوشهٔ Inbox دسترسی پیدا کنید و تعداد کل پیام‌های موجود در آن را دریافت کنید.

ذخیره پیام‌ها بر روی دیسک سخت محلی

پس از انتخاب یک پوشه با متد SelectFolder، از تابع ListMessages برای دریافت لیستی از تمام پیام‌های موجود در پوشه در یک شیء ImapMessagesInfoCollection استفاده کنید. در این مجموعه iteration کنید و پیام‌های ایمیل را به درایو محلی کامپیوتر به صورت زیر ذخیره کنید:

ایجاد یک پوشه جدید

پروتکل IMAP همچنین امکان ایجاد یک پوشهٔ جدید بر روی سرور ایمیل را می‌دهد. این کار می‌تواند با یک فراخوانی سادهٔ تابع انجام شود.

ایجاد یک پیام جدید در پوشه

یک پیام جدید را به پوشه اضافه کنید با استفاده از MailMessage و ImapClient کلاس‌ها. مثال‌های زیر ابتدا یک شیء MailMessage را با ارائه مقدار موضوع، گیرنده و فرستنده ایجاد می‌کنند. سپس به یک پوشه مشترک می‌شوند و پیام را به آن اضافه می‌کنند. قطعه کد زیر نشان می‌دهد چگونه یک پیام جدید در یک پوشه ایجاد کنید.

POP3

این مقاله برخی مثال‌ها را که از پروتکل POP3 روی SSL استفاده می‌کنند، نشان می‌دهد. برای اتصال به سروری که با SSL محافظت شده است، باید پورت SSL و دو ویژگی اضافی را تعریف کنیم. بقیه کد همانند اتصال به یک سرور POP3 معمولی است.

نمونه‌های کد زیر نشان می‌دهند چگونه:

اتصال به سرور SSL.
بررسی وضعیت صندوق پست
دریافت اطلاعات درباره پیام
دریافت ایمیل‌ها.

اتصال به سرور ایمیل

با استفاده از اتصال به سرور ایمیل فعال بر روی SSL Pop3client کلاس همان‌طور که در زیر توضیح داده شده است.

بررسی وضعیت صندوق پست

قطعه کد زیر نشان می‌دهد چگونه تعداد پیام‌های ذخیره‌شده در صندوق پست و اندازهٔ آن را بررسی کنید. استفاده کنید Pop3MailboxInfo کلاس برای این منظور.

بررسی اطلاعات پیام

این مثال تمام پیام‌های موجود در صندوق پست را با استفاده از Pop3MessageInfoCollection کلاس. از Pop3Client.ListMessages() تابعی برای دریافت Pop3MessageInfoCollection مجموعه. سپس از میان مجموعه پیمایش کنید تا اطلاعات پیام را بخوانید: شناسه پیام، شاخص، موضوع و اندازه

دریافت پیام‌ها

برای دریافت پیام‌ها از صندوق پست، از Pop3Client متد FetchMessage() کلاس برای دریافت پیام به یک MailMessage نوع شیء. قطعه کد زیر نشان می‌دهد چگونه تعداد ایمیل‌های موجود در صندوق پست را شمارش کنید و سپس از میان آنها پیمایش کنید تا هر یک را بازیابی نمایید.

Net: معرفی الگوهای تکرار

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

می‌توانید یک recurrence pattern را به‌عنوان روشی برای توصیف برنامه زمانی خاص درنظر بگیرید. این الگو به اندازه کافی اطلاعات دارد تا فهرستی از وقوع‌ها (تاریخ‌ها و زمان‌ها) را بر پایه برنامه داده‌شده ایجاد کند. یک الگوی تکرار ممکن است شامل قوانین تکرار باشد که چرخه‌هایی را توصیف می‌کنند که با هم ترکیب می‌شوند تا الگوی کلی را تشکیل دهند. به‌طور کلی، هر چه الگوی تکرار پیچیده‌تر باشد، قوانین تکرار بیشتری خواهد داشت. الگوهای تکرار می‌توانند شامل exceptions باشند (به‌اشتباه با استثناهایی که نشانگر خطاهای رخ داده در زمان اجرا هستند، مخلوط نشوند). استثناها تاریخ‌های وقوع را به الگوی اصلی اضافه یا حذف می‌کنند. استثناها می‌توانند به‌صورت وقوع‌های صریح یا به‌عنوان یک الگو خودشان مشخص شوند. مثال‌هایی از الگوهای تکرار با استثناها:

هر دومین جمعه، به‌جز ماه‌های ژوئن تا آگوست.
اولین روز هر ماه، به‌جز ژانویه که باید در روز دوم باشد.

الگوهای تکرار اغلب دوره‌ای هستند، اما لازم نیست. یک الگوی تکرار می‌تواند کاملاً به عنوان مجموعه‌ای از تاریخ‌ها و زمان‌های پیش‌تعریف‌شده توصیف شود. RFC iCalendar components را تعریف می‌کند، مانند VEVENT یا VTODO که نمایانگر رویدادها یا وظایف هستند. این کامپوننت‌ها می‌توانند ویژگی‌هایی مانند تاریخ و زمان شروع، توضیح، مکان، شرکت‌کنندگان و تکرار داشته باشند. بنابراین یک الگوی تکرار معمولاً به عنوان ویژگیی از یک کار یا رویداد تکراری وجود دارد. ویژگی‌های الگوی تکرار که توسط iCalendar تعریف شده‌اند:

DTSTART - تاریخ و زمان شروع الگو (همچنین اولین وقوع را اگر به‌طور صریح مستثنی نشود، نشان می‌دهد).
RRULE - قانونی برای تکرار یک مجموعهٔ تکرار را مشخص می‌کند.
RDATE - فهرستی از تاریخ‌ها و زمان‌ها را برای گنجاندن در یک مجموعهٔ تکرار تعریف می‌کند.
EXRULE - قانونی برای استثناهای یک مجموعهٔ تکرار را مشخص می‌کند.
EXDATE - فهرستی از تاریخ‌ها و زمان‌های استثنا از یک مجموعهٔ تکرار را تعریف می‌کند.

تنها DTSTART الزامی است و باید فقط یک DTSTART وجود داشته باشد. تمام خصوصیات دیگر اختیاری هستند و می‌توانند بیشتر از یک بار مشخص شوند. Aspose.iCalendar یک رشته در قالب iCalendar می‌گیرد و الگوی تکرار را به یک RecurrencePattern شیء. رشته می‌تواند توصیف کامل یک مؤلفهٔ iCalendar (مثلاً یک VEVENT کامل) باشد یا فقط قطعه‌ای که شامل الگوی تکرار است. پس از بارگذاری الگوی تکرار در شیء RecurrencePattern، می‌توانید:

الگو را به‌صورت برنامه‌نویسی بررسی و اصلاح کنید با استفاده از متدها و خصوصیات ارائه‌شده توسط 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 مراجعه کنید.

الگوهای نمونه

این بخش شامل موضوعات زیر است:

آخرین روز ماه.
آخرین روز کاری هر ماه.
آخرین دوشنبهٔ سال.
جمعهٔ اولین هفتهٔ 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، اولین هفتهٔ سال هفته‌ای است که حداقل چهار روز دارد. به‌عنوان مثال، زمانی که سال با شنبه شروع می‌شود، هفتهٔ ۱ همان هفته‌ای است که بلافاصله پس از آن، از دوشنبهٔ ۳ ژانویه آغاز می‌شود.

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 را دنبال کنند. مثال زیر تاریخ ۱۴ ژوئیه ۱۹۹۷ را نشان می‌دهد: 19970714

DATE‑TIME با زمان محلی

فرم تاریخ با زمان محلی صرفاً یک مقدار تاریخ‑زمان است که نشانگر UTC را ندارد و به منطقه زمانی ارجاع نمی‌دهد. به عنوان مثال، رشته زیر تاریخ ۱۸ ژانویه ۱۹۹۸ ساعت ۲۳:۰۰ (۱۱ شب) را نشان می‌دهد: DTSTART:19980118T230000. مقادیر تاریخ‑زمان از این نوع به‌عنوان «شناور» شناخته می‌شوند و به‌هیچ منطقه زمانی خاصی متصل نیستند. آنها برای نمایاندن همان مقدار ساعت، دقیقه و ثانیه صرف نظر از منطقه زمانی که در حال حاضر مشاهد می‌شود، استفاده می‌شوند.

DATE‑TIME با زمان UTC

تاریخ با زمان UTC یا زمان مطلق، با حرف بزرگ لاتین Z به عنوان پسوند، که نشانگر UTC است، به مقدار زمان اضافه می‌شود. به‌عنوان مثال، عبارت زیر تاریخ ۱۹ ژانویهٔ ۱۹۹۸ ساعت ۰۷:۰۰ UTC را نشان می‌دهد: DTSTART:19980119T070000Z. لطفاً توجه داشته باشید که Aspose.iCalendar پسوند Z فرمت UTC را نادیده می‌گیرد و زمان را به‌عنوان زمان محلی درنظر می‌گیرد. استاندارد RFC2445 بیان می‌کند که بخش زمانی مشخص‌شده در قانون UNTIL یک الگوی تکرار باید به فرم UTC باشد. این یک بیان بسیار عجیب است و در واقع مثال‌هایی در استاندارد وجود دارد که به‌درستی محاسبه نشده‌اند. Aspose.iCalendar زمان را در هر فرمتی در قانون UNTIL می‌پذیرد.

DATE‑TIME با زمان محلی و منطقه زمانی

برای ارجاع به منطقهٔ زمانی، DATE‑TIME با ویژگی TZID اصلاح می‌شود. به‌عنوان مثال، عبارت زیر ساعت ۲ صبح در نیویورک در ۱۹ ژانویهٔ ۱۹۹۸ را نشان می‌دهد: DTSTART;TZID=US‑Eastern:19980119T020000. لطفاً توجه داشته باشید که در حال حاضر Aspose.iCalendar پارامتر TZID را نادیده می‌گیرد و زمان را به‌عنوان زمان محلی درنظر می‌گیرد.

BYWEEKNO سازگاری با ISO 8601 را فراهم می‌کند

از BYWEEKNO فقط زمانی استفاده کنید که با ISO 8601 نیاز است. شماره‌های هفته بر اساس ISO 8601 بسیار متفاوت از شماره‌های هفته به معنای معمول هستند. بر وفقان ISO 8601، شماره هفته یک سال تقویمی اولین هفته‌ای است که حداقل چهار روز دارد. این قانون الگوریتم را برای برنامه‌هایی که نیاز به سازگاری با ISO 8601 دارند خاص می‌کند و تقریباً برای کاربردهای دیگر غیرقابل استفاده می‌شود. ISO 8601 توسط برخی برنامه‌های بانکی و مالی اروپایی پشتیبانی می‌شود. همچنین در تلویزیون برای رزرو تبلیغات استفاده می‌شود. قانون BYWEEKNO یک فهرست عددی جدا شده با کاما را که هفتۀ‌های سال را شناسایی می‌کند، مشخص می‌نماید. مقادیر معتبر ۱ تا ۵۳ و ۱ تا ۵۳ هستند. این با هفتۀ‌ها مطابق شماره‌گذاری هفته تعریف شده در ISO 8600 مطابقت دارد. 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

هنگامی که می‌خواهید اعلان تحویل را برای هر دو پیام ارسال‌شده با موفقیت و ناموفق دریافت کنید، می‌توانید از عملگر لوله (|) برای 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، باید SDK SharePoint بر روی سیستم نصب شود. SDK API لازم برای ورود و دسترسی به فایل‌ها از کتابخانه اسناد را فراهم می‌کند.

خواندن پیام‌های ایمیل از SharePoint

نمونه‌های برنامه‌نویسی زیر فرض می‌کنند که یک فایل پیام Microsoft Outlook (.msg) قبلاً در پوشه SharedDocument کتابخانه اسناد SharePoint ذخیره شده است. SDK SharePoint برای دریافت فایل پیام به‌صورت استریم استفاده می‌شود و سپس این استریم به یک نمونه از MailMessage کلاس. کلاس MailMessage استریم را بارگذاری کرده و فایل پیام Outlook را تجزیه می‌کند. پس از آن می‌توانید به ویژگی‌های کلاس MailMessage، مانند موضوع، بدنهٔ متنی، بدنهٔ HTML و غیره دسترسی پیدا کنید تا اطلاعات را در یک پروژه Visual Studio استفاده کنید. برای اطلاعات در مورد نحوه نصب و پیکربندی Microsoft SharePoint Server و SDK، لطفاً به بخش‌های مربوطه در کتابخانه MSDN مراجعه کنید. قطعه کد زیر نشان می‌دهد چگونه پیام‌های ایمیل را از SharePoint بخوانید.

Net: تنظیم رمزگذاری متن پیش‌فرض در پیام ایمیل

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

این مقاله معرفی می‌کند MailMessage.PreferredTextEncoding ویژگی و توضیح نحوه استفاده از آن. با استفاده از این ویژگی، می‌توانید رمزگذاری متن پیش‌فرض را برای ویژگی‌های زیر تنظیم کنید:

از: نام نمایش
به: نام نمایش
Subject
بدنه

تنظیم رمزگذاری متن پیش‌فرض

در نسخه‌های قبلی Aspose.Email، رمزگذاری متن برای ویژگی‌های from، to، subject و body به‌صورت جداگانه تنظیم می‌شد. برای بهبود قابلیت استفاده، ما ویژگی PreferredTextEncoding ویژگی‌ای که همه را به‌صورت یک‌باره تنظیم می‌کند. اکنون راحت‌تر است اطمینان حاصل کنید که تمام متن‌های موجود در ویژگی‌های فوق به‌درستی در پیام ایمیل رمزگذاری شده‌اند. کد نمونه زیر نشان می‌دهد چگونه یک کلمه فرانسه را به عنوان نام قابل نمایش برای آدرس‌های ایمیل، موضوع و متن استفاده کنید.

Net: تبدیل فایل پیام Outlook (MSG) به تصویر TIFF

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

در این مقاله، نحوه تبدیل یک فایل MSG Outlook به تصویر TIFF را نشان می‌دهیم.

ابتدا، یک فایل MSG را بخوانید و با Aspose.Email برای .NET به فرمت MHTML تبدیل کنید. از 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 Northwind به Microsoft Word استخراج شده است، در زیر قابل مشاهده است.

هنگامی که پیام در 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
واحدهای صفحه می‌توانند یکی از این‌ها باشند: اینچ، پیکسل، پوینت، سانتیمتر یا میلی‌متر.

قطعه کد زیر از تنظیمات دلخواه استفاده می‌کند تا نشان دهد این خصوصیات چگونه به کار می‌روند. صفحه‌ای به ارتفاع 20 سانتیمتر و عرض 8 سانتیمتر، با حاشیه‌های 2 سانتیمتر تنظیم می‌کند.

خودتنظیم یک TIFF

Aspose.Email.Printing ارائه می‌دهد MessageFormattingFlags.AutoFitWidth خصوصیتی که به شما امکان می‌دهد TIFF را به‌صورت خودکار برای چاپگر تنظیم کنید. قطعه کد زیر نشان می‌دهد چگونه از Auto-fit استفاده کنید.

تنظیم DPI هدف برای خروجی TIFF

قطعه کد زیر نشان می‌دهد چگونه از DPI برای خروجی TIFF استفاده کنید.

Net: استفاده از یک Worksheet اکسل مایکروسافت به‌عنوان بدنه پیام و ارسال ایمیل

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

این مقاله از یک Workbook اکسل مایکروسافت به‌عنوان بدنهٔ ایمیل استفاده می‌کند و آن را برای دریافت‌کنندگان ارسال می‌نماید. Aspose.Email برای .NET با پروتکل‌های شبکه و ویژگی‌های Microsoft Outlook سروکار دارد و نمی‌تواند به‌صورت مستقیم با Workbookهای اکسل کار کند. برای رفع این مشکل، نمونه‌های این مقاله از Aspose.Cells برای .NET استفاده می‌کنند تا Workbook اکسل را بارگذاری و به استریم HTML تبدیل کنند. سپس Aspose.Email برای .NET از استریم HTML به‌عنوان بدنهٔ ایمیل استفاده می‌نماید. نمونهٔ برنامه‌نویسی نشان می‌دهد چگونه یک Worksheet اکسل را به‌عنوان بدنهٔ ایمیل با استفاده از Aspose.Cells برای .NET و Aspose.Email برای .NET ارسال کنیم.

بارگذاری یک Workbook اکسل مایکروسافت با استفاده از کلاس Workbook در Aspose.Cells
پوشه‌کار بارگذاری‌شده را به MemoryStream در قالب HTML ذخیره کنید
HTML را از استریم به‌عنوان رشته دریافت کنید
یک شیء MailMessage جدید تعریف کنید و HtmlBody آن را به محتوای HTML مرحلهٔ ۳ تنظیم کنید
ارسال ایمیل با استفاده از کلاس SmtpClient در Aspose.Email برای .NET

پوشه‌کار (Workbook) اصلی اکسل می‌تواند به صورت زیر مشاهده شود:

زمانی که پیام ارسال و در Microsoft Outlook دریافت شد، به شکل زیر نمایش داده می‌شود:

قطعه کد زیر نشان می‌دهد چگونه Worksheet اکسل مایکروسافت را به‌عنوان بدنه پیام ارسال کنید و ایمیل بفرستید.

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 استفاده کنید. قطعه کد زیر نشان می‌دهد چگونه با nNextOccurrences = 20، 20 رخداد تولید کنید. خروجی کد زیر به صورت زیر است:

دریافت متن کاربرپسند برای یک تکرار

متن کاربرپسند برای یک قاعده می‌تواند با استفاده از ویژگی FriendlyText همان‌طور که در زیر نشان داده شده است، به‌دست آید. خروجی کد به شکل زیر خواهد بود: "هر ماه در روز اول و اولین روز از انتهای روز(ها) ماه تکرار شود تا حداکثر ۲ رخداد.". قطعه کد زیر نشان می‌دهد چگونه متن کاربرپسند برای یک تکرار دریافت کنید.

Net: دسترسی به سرویس‌های ایمیل با استفاده از OAuth

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

پشتیبانی از OAuth 2.0 به Aspose.Email اضافه شده است و می‌تواند برای دسترسی به سرورهای SMTP، POP3، IMAP و EWS استفاده شود. به طور کلی، تمام سرورهایی که توکن‌های حامل OAuth 2.0 را پشتیبانی می‌کنند می‌توانند با Aspose.Email استفاده شوند، اما کلاینت‌های ایمیل ما با سرورهای ایمیل گوگل و سرورهای Microsoft Office 365 آزمایش شده‌اند. دسترسی به سرور از طریق SmtpClient, Pop3Client, ImapClient و EWSClient با OAuth می‌تواند به دو روش پیاده‌سازی شود.

توکن دسترسی را مستقیماً به سازندهٔ کلاینت ایمیل ارائه کنید. در این حالت، کاربر باید بداند که طول عمر توکن‌های دسترسی محدود است. هنگامی که توکن منقضی شود، کلاینت ایمیل نمی‌تواند برای دسترسی به سرور استفاده شود.
ارائه یک پیاده‌سازی سفارشی از ارائه‌دهنده توکن بر پایه ITokenProvider رابط کاربری به سازندهٔ کلاینت ایمیل. در این حالت، کلاینت زمان انقضای توکن را بررسی می‌کند و درخواست می‌کند ITokenProvider برای دریافت توکن دسترسی جدید زمانی که توکن قبلی منقضی شده باشد. به این ترتیب، کلاینت به‌طور دوره‌ای توکن‌ها را تازه‌سازی می‌کند و می‌تواند برای زمان نامحدود با سرور کار کند. اکثر سرویس‌ها روش ساده‌ای برای تازه‌سازی توکن‌های دسترسی ارائه می‌دهند. برای مثال، استفاده از توکن‌های تازه‌سازی در سرویس‌های گوگل یا جریان احراز هویت ROPC در پلتفرم هویت مایکروسافت می‌تواند برای پیاده‌سازی ارائه‌دهنده توکن استفاده شود.

پیکربندی حساب بر روی سرور مناسب

مقالات زیر به شما کمک می‌کنند حساب‌ها را برای دسترسی به سرویس‌های ایمیل پیکربندی کنید.

برای Office 365
برای جیمیل

دسترسی به سرویس‌های ایمیل با توکن‌های دسترسی

نمونه‌های کد زیر نشان می‌دهند چگونه با استفاده از توکن‌های دسترسی به سرویس‌های ایمیل متصل شوید.

// 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))
{

}

پیاده‌سازی 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 در دسترس کاربر هستند. بنابراین نیاز است روشی طراحی شود که بتواند هنگام استفاده از MapiMessage ضمیمهٔ Inline و معمولی را تفکیک کند.

استفاده از Aspose.Email برای تفکیک ضمیمه‌های Inline و معمولی

این مقاله توضیح می‌دهد چگونه با استفاده از MapiMessage ضمیمه‌های Inline را از ضمیمه‌های معمولی تفکیک کنیم. برای تعیین این تفکیک، نوع بدنهٔ MapiMessage به‌صورت زیر در نظر گرفته می‌شود:

بدنه متن ساده: پیام‌های ایمیل با نوع بدنهٔ متن ساده نیازی به بررسی ندارند، چون تمام ضمیمه‌های این پیام‌ها همیشه ضمیمه‌های معمولی هستند.

بدنه Html: در مورد پیامی که نوع بدنهٔ HTML دارد، ضمیمه نه تنها باید ویژگی PR_ATTACH_FLAGS (0x37140003) را داشته باشد، بلکه مقدار آن باید برای ضمیمه‌های Inline برابر 0x00000004 باشد. اگر این شرط برآورده شود، سپس رفتار بر پایه تگ‌های PR_ATTACH_CONTENT_LOCATION و PR_ATTACH_CONTENT_ID برای تعیین نوع ضمیمه تعیین می‌گردد. با این حال، در عدم وجود تگ Mapi PR_ATTACH_FLAGS، ضمیمه برای ویژگی PR_ATTACH_DISPOSITION (0x3716001F یا 0x3716001E) بررسی می‌شود تا نوع ضمیمه مشخص شود.

بدنه Rtf: اگر بدنه RTF باشد، تمام ضمیمه‌های OLE به‌عنوان ضمیمه‌های Inline در نظر گرفته می‌شوند. مقدار PR_ATTACH_METHOD برای تمام ضمیمه‌های OLE برابر با 0x00000006 است.

نمونهٔ کد زیر نشان می‌دهد چگونه به‌صورت برنامه‌ای بین ضمیمه‌های Inline و معمولی تفکیک کنیم. تابع IsInlineAttachment یک ضمیمه و نوع بدنهٔ پیام را به‌عنوان پارامترهای ورودی می‌گیرد و اگر ضمیمه یک Inline باشد مقدار true برمی‌گرداند.

Net: ارسال ایمیل با استفاده از DNS

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

گاهی ارسال ایمیل‌ها با استفاده از سرور SMTP برای نیازهای پروژه قابل‌اجرا نیست. ممکن است بخواهیم از رکورد MX دامنهٔ گیرنده استفاده کنیم. قطعه کد زیر نشان می‌دهد چگونه با استفاده از سرورهای ایمیل دامنهٔ گیرنده ایمیل‌ها را ارسال کنیم.

Net: استخراج داده‌های اشیای توکار

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

گاهی داده‌های OLE Embedded به‌صورت پیوست "oleData.mso" توسط MapiAttachment و نیاز به استخراج دستی دارد. این فایل‌های oleData.mso فرمت Microsoft Computer Document File (MCDF) هستند و پشتیبانی از چنین فایل‌هایی فراتر از حوزه Aspose.Email است. با این حال، می‌توان از Aspose.Email به‌همراه کتابخانه‌های متن‌باز دیگر، مانند OpenMCDF، برای خواندن محتوای این فایل‌ها به منظور ذخیره بر روی دیسک استفاده کرد. Aspose.Email ارائه می‌دهد InlineAttachmentExtractor کلاسی برای شمارش بسته‌های MSO از داده‌های باینری oledata.mso که سپس می‌تواند برای استخراج محتوا توسط کتابخانه‌های خواندن فایل‌های مرکب استفاده شود.

اگر نوع بدنه پیام 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 امکان تولید درخواست جلسه با تکرار وجود دارد. این مقاله توضیح می‌دهد چگونه می‌توان درخواست جلسه‌ای با تکرار خاص تولید کرد. شناسه منحصر به‌فرد قرار ملاقات می‌تواند برای استفاده‌ی بعدی در ارسال هر بروز‌رسانی به قرار ملاقات ذخیره شود.

ایجاد درخواست جلسه با تکرار

کد نمونه زیر نشان می‌دهد چگونه این کار انجام شود.

ارسال درخواست بروزرسانی قرار ملاقات

برای ارسال به‌روزرسانی برای قرار ملاقات قبلی، شناسه منحصر به‌فرد لازم است. کد نمونه زیر نشان می‌دهد چگونه این درخواست به‌روزرسانی قرار ملاقات ارسال می‌شود

Net: پشتیبانی از چندریسه در کلاینت‌های ایمیل

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

کلاینت‌های ایمیل مانند ImapClient و Pop3Client به کاربران امکان استفاده از آنها در محیط چندنخی را می‌دهند. این کلاینت‌ها می‌توانند یک یا چند اتصال با سرور داشته باشند. برای مدیریت مجموعه‌ای از اتصالات داخل کلاینت‌ها از استخر اتصال استفاده می‌شود. تعداد اتصالاتی که می‌توانند همزمان ایجاد و استفاده شوند، توسط ویژگی CredentialsByHostClient.MaxConnectionsPerServer محدود می‌شود. این ویژگی می‌تواند به مقدار 1 یا بزرگ‌تر تنظیم شود. به‌طور پیش‌فرض این مقدار برابر 10 است. صف دستورات برای اتصال پیاده‌سازی شده است تا از عملیات چندنخی پشتیبانی کند. دستورات ساده‌ای که در پروتکل تعریف شده‌اند مانند Noop، Authenticate و غیره اجرا می‌شوند. کاربر ممکن است تعداد دستورات بیشتری نسبت به تعداد اتصالات موجود شروع کند. اما این دستورات تنها زمانی اجرا می‌شوند که کلاینت بتواند برای عملیات یک اتصال ایجاد کند.

روش‌های استفاده از کلاینت‌های ایمیل در محیط چندنخی

کلاینت‌های ایمیل رفتارهای زیر را دارند:

1. در صورتی که MaxConnectionsPerServer = 1 باشد، کلاینت یک اتصال ایجاد می‌کند، احراز هویت و مجوزدهی را انجام می‌دهد. این اتصال تا زمان از بین رفتن کلاینت در حالت کاری حفظ می‌شود. تمام عملیات‌ها از ریسمان‌های مختلف به یک صف دستورات که در اتصال اصلی قرار دارد هدایت می‌شوند.

2. در صورتی که MaxConnectionsPerServer > 1 باشد، کلاینت تعداد مورد نیاز اتصالات را ایجاد می‌کند و برای هر اتصال احراز هویت و مجوزدهی را انجام می‌دهد. یک اتصال به عنوان اتصال اصلی رزرو می‌شود. این اتصال تا زمانی که کلاینت از بین برود در حالت کاری حفظ می‌شود. سایر اتصالات بر حسب نیاز ایجاد و از بین می‌روند. حداکثر تعداد این اتصالات توسط ویژگی MaxConnectionsPerServer تعریف می‌شود، به طور مثال اگر MaxConnectionsPerServer = 2 باشد، یک اتصال به عنوان اصلی رزرو می‌شود و اتصال دوم به عنوان اضافه برای عملیات‌هایی که در ریسمان‌های دیگر اجرا می‌شوند استفاده می‌شود. به همین ترتیب اگر MaxConnectionsPerServer = 3 باشد، اولین اتصال به عنوان اصلی رزرو شده و دو اتصال دیگر به عنوان اضافه برای عملیات‌های اجرا شده در ریسمان‌های دیگر استفاده می‌شوند. در صورتی که درخواست بعدی برای اتصال از ریسمان جدیدی بیاید و تمام اتصالات در حال استفاده باشند، کلاینت تا کاهش تعداد اتصالات استفاده‌شده صبر می‌کند….

مثال‌ها

کاربر می‌تواند عملیات‌ها را در ریسمان‌های مختلف به چند روش اجرا کند. این روش‌ها به دو نوع تقسیم می‌شوند:

1. کاربر از متدهای ناهمزمان (Begin/End) تعریف شده در کلاینت استفاده می‌کند. در این حالت کلاینت ایمیل وقتی نیاز باشد ریسمان‌های جدیدی راه‌اندازی می‌کند. در کلاینت یک صف وظایف پیاده‌سازی شده است (لطفاً آن را با صف دستورات در اتصال اشتباه نگیرید). یک وظیفه می‌تواند اجرا شود اگر اتصال در دسترس باشد. زمانی که تعداد اتصالات استفاده‌شده کمتر از مقدار محدودیت می‌شود، کلاینت یک اتصال جدید ایجاد می‌کند، ریسمان برای وظیفه فعلی می‌سازد و این وظیفه را اجرا می‌کند. مثال استفاده از عملیات‌های ناهمزمان:

۲. کاربر می‌تواند با استفاده از اشیائی مانند Thread، ThreadPool، Task یا هر شیء دیگری برای این منظور، رشته‌ها (threads) ایجاد کند. همچنین کاربر می‌تواند از رشته‌های ایجاد شده در کدهای شخص ثالث استفاده کند. در این حالت، کلاینت دو مدل رفتار دارد

a. اگر کاربر ایجاد اتصالات اضافه برای عملیات در ریسمان را در نظر نگرفته باشد، تمام عملیات‌های این ریسمان به صف دستورات برای اتصال اصلی ارسال می‌شوند. یک مثال از عملیات‌ها در یک ریسمان اضافه بدون ایجاد اتصال جدید، تمام تراکنش‌ها از طریق اتصال اصلی انجام می‌شود:

b. وقتی کاربر متدی را اجرا می‌کند تا اتصال جدیدی برای ریسمان اضافه ایجاد کند، این ریسمان تا زمانی که مقدار سهمیه برای اتصالات جدید تغییر کند مسدود می‌شود تا اتصال جدید مجاز شود. سپس اتصال جدید ایجاد می‌شود. این اتصال به عنوان اتصال پیش‌فرض برای تمام عملیات‌ها در این ریسمان تنظیم می‌گردد. پس از اتمام تمام عملیات‌ها در این ریسمان، باید اتصال را از بین برد. برای ایجاد اتصالات جدید از متد CredentialsByHostClient.CreateConnection استفاده کنید. این متد شی‌ای را برمی‌گرداند که اینترفیس IDisposable را پیاده‌سازی می‌کند. برای آزادسازی اتصال باید متد 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 همچنین قابلیت ترکیب قالب (mail‑merge) مبتنی بر قالب را فراهم می‌کند که می‌تواند برای ترکیب ایمیل در ارسال خبرنامهٔ انبوه استفاده شود. وظایف بسیاری دیگر نیز وجود دارد که Aspose.Email.Mail می‌تواند در یک برنامهٔ بازاریابی ایمیلی انجام دهد.

ابزارهای دیگر بازاریابی

مشابه برنامه‌های خبرنامه، بسیاری از انواع دیگر نرم‌افزارها می‌توانند با استفاده از Aspose.Email.Mail ساخته شوند. از آن برای ساخت بازاریابی ایمیلی، ارسال ایمیل انبوه و کمپین‌های الکترونیکی و موارد دیگر استفاده کنید.

برنامه‌های تجاری

Aspose.Email.Mail می‌تواند در تقریباً تمام انواع برنامه‌های تجاری برای انجام وظایف کمکی استفاده شود:

هشدارهای ایمیلی: هشدارهای ایمیلی را برای اطلاع‌رسانی به کاربران درباره فعالیت‌ها ارسال کنید.
درخواست‌های جلسه: با استفاده از پشتیبانی iCalendar در Aspose.Email.Mail درخواست‌های جلسهٔ تجاری را ارسال کنید.
ایمیل گزارش‌های زمان‌بندی‌شده: گزارش‌ها بخش جدایی‌ناپذیری از اکثر برنامه‌های تجاری هستند. بسیاری از گزارش‌های تجاری در فواصل زمانی تولید می‌شوند. از Aspose.Email.Mail برای ایمیل کردن گزارش‌های زمان‌بندی‌شده استفاده کنید.

کلاینت‌های ایمیل

Aspose.Email.Mail می‌تواند در کلاینت‌های ایمیل برای ارسال ایمیل‌های عادی نیز استفاده شود. این کتابخانه از پیوست‌ها، اشیای توکار، رویدادهای iCalendar، ادغام نامه‌ها, ارسال ایمیل‌های انبوه و غیره پشتیبانی می‌کند، بنابراین Aspose.Email.Mail بهترین گزینه برای ایجاد برنامه‌های کلاینت ایمیل مبتنی بر ویندوز یا وب است.

برنامهٔ نمونه Aspose.Email.Mail

برای نشان دادن نحوه استفاده از Aspose.Email.Mail، برنامه‌ای به نام ‘My First Email’ ایجاد می‌کنیم که چگونگی ساخت یک پیام ایمیلی را با استفاده از کلاس MailMessage و سپس آن را با استفاده از کلاس SmtpClient ارسال کنید.

Mail : مراحل برنامه نمونه

لطفاً مراحل زیر را برای ایجاد برنامهٔ ‘My First Mail’ با استفاده از Aspose.Email دنبال کنید.

Visual Studio را باز کنید.
از منوی File، New را انتخاب کنید، سپس Project. (انتخاب کنید که برنامهٔ ویندوزی C# یا VB.NET ایجاد کنید).
اگر لایسنس دارید، آن را اعمال کنید تا از نسخهٔ کامل Aspose.Email استفاده کنید.
DLL Aspose.Email را با کلیک راست بر روی Reference در Solution Explorer به برنامه وارد کنید.
برنامهٔ ویندوزی خود را طراحی کنید: یک رابط کاربری بسازید که سه فیلد From، To و Message را دریافت کند.
دوبار کلیک کنید روی دکمه Send در نمای طرح و کد خود را در ویرایشگر بنویسید.
یک نمونه از کلاس MailMessage ایجاد کنید و از ویژگی‌های آن برای ساختن یک پیام ایمیل استفاده کنید. (نمونه‌های کلاس MailMessage برای ساختن پیام‌های ایمیلی استفاده می‌شوند که برای تحویل به سرور SMTP از طریق کلاس SmtpClient ارسال می‌شوند).
یک نمونه از کلاس SmtpClient ایجاد کنید و از ویژگی‌های آن برای ارسال یک پیام ایمیل استفاده کنید.
برنامهٔ ویندوزی خود را با فشار دادن F5 تست کنید.
آدرس‌ها را در فیلدهای From و To وارد کنید.
یک پیام را در فیلد Message Body تایپ کنید.
Send را کلیک کنید.

مراحل فوق در زیر توضیح داده شده‌اند؛ دابل‌کلیک کنید روی دکمه Send در نمای طرح و کد زیر را اضافه کنید:

هنگام اتصال به سروری که SSL فعال است، باید ویژگی‌های شیء SMTPClient زیر را تنظیم کنیم

نتیجه‌گیری

Aspose.Email.Mail یک مؤلفهٔ بسیار قدرتمند است که با آن توسعه‌دهندگان می‌توانند تقریباً تمام وظایف ایمیلی را انجام دهند، مانند ارسال ایمیل‌های انبوه چندنخی، استفاده از mail‑merge، افزودن پیوست‌ها، جاسازی تصاویر و صداها در پیام‌های ایمیل، افزودن رویدادهای iCalendar به ایمیل‌ها، دریافت ایمیل‌ها و غیره.

Aspose.Email.Pop3

Aspose.Email.Pop3 پروتکل Post Office Protocol v3 (POP3) را بر روی چارچوب .NET پیاده‌سازی می‌کند. این امکان را به توسعه‌دهندگان .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.
یک برنامهٔ ویندوزی C# یا VB.NET انتخاب کنید.
DLL Aspose.Email را با کلیک راست بر روی Reference در Solution Explorer به برنامه وارد کنید.
حال برنامهٔ ویندوزی را مطابق تصویر زیر طراحی کنید.
یک نمونه از 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 پیاده‌سازی می‌کند. Aspose.Email.Imap به توسعه‌دهندگان .NET امکان افزودن قابلیت‌های IMAP به برنامه‌های خود را به‌سرعت می‌دهد، بدون نیاز به درک جزئیات پروتکل. این مؤلفه از واکشی و آپلود پیام‌ها، بررسی وضعیت جدید/خوانده‌شده/نخوانده پیام‌ها و غیره پشتیبانی می‌کند.

Imap : ویژگی‌های اصلی

Aspose.Email.Imap به شما اجازه می‌دهد:

پیام‌های ایمیل را دریافت کنید.
بارگذاری پیام‌های ایمیل.
لیست پیام‌های ایمیل در پوشه‌های مختلف.
بررسی وضعیت پیام‌های ایمیل.
کار با MailMessage.
کار با پشتیبانی SSL.

استفاده از Aspose.Email.Imap

Aspose.Email.Imap پروتکل Internet Message Access Protocol را بر روی چارچوب‌های .NET پیاده‌سازی می‌کند. با استفاده از آن، توسعه‌دهندگان می‌توانند به‌سادگی ایمیل‌های سرور 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.
یک برنامهٔ ویندوزی C# یا VB.NET انتخاب کنید.
DLL Aspose.Email را با کلیک راست بر روی 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 متصل شوید، پیام‌ها را فهرست کنید و ایمیل‌ها را دانلود کنید. این مؤلفه از فهرست‌کردن پیام‌ها، ارسال ایمیل‌ها، دانلود پیام‌ها و ذخیره‌سازی به قالب eml یا msg بر روی دیسک محلی و غیره پشتیبانی می‌کند.

Exchange : ویژگی‌های اصلی

Aspose.Email.Exchange به شما امکان می‌دهد:

اتصال به سرورهای Microsoft Exchange.
لیست پیام‌های ایمیل در صندوق‌های ایمیل Exchange.
لیست پیام‌های ایمیل از پوشه‌های مختلف، برای مثال Inbox، Sent، Deleted یا Drafts.
حذف پیام‌ها در هر پوشه‌ای از سرورهای Exchange.

استفاده از Aspose.Email.Exchange

با Aspose.Email.Exchange، توسعه‌دهندگان می‌توانند به صندوق‌های پست سرور Exchange از برنامه‌های .NET خود دسترسی داشته باشند. این کتابخانه یک API راحت برای مدیریت ایمی‌ل‌ها روی سرورهای Exchange ارائه می‌دهد. توسعه‌دهندگان می‌توانند برنامه‌های کنسولی، دسکتاپ یا وبی بسازند که ایمی‌ل‌های موجود در صندوق‌های Exchange را مدیریت می‌کند.

نمونه برنامه Aspose.Email.Exchange

این مقاله نشان می‌دهد چگونه از Aspose.Email.Exchange. یک برنامه دسکتاپ ساده ایجاد می‌کنیم که به صندوق‌پست سرور Exchange متصل می‌شود، فهرست پیام‌ها در پوشه Inbox را دریافت می‌کند و آنها را در فرم ویندوز نمایش می‌دهد.

Exchange : مراحل برنامه نمونه

Microsoft Visual Studio را باز کنید.
یک پروژه جدید ایجاد کنید. (زبان مورد نظر خود را انتخاب کنید، C# یا VB.NET)
یک مرجع به Aspose.Email.dll را به پروژه‌تان اضافه کنید با کلیک راست روی پروژه و انتخاب Add Reference از منو.
یک فرم ویندوزی مشابه فرم زیر طراحی کنید:

برای اجرای موفقیت‌آمیز برنامه، نیاز به اطلاعات‌اعتباری صحیح برای دسترسی به سرور Exchange دارید. در اینجا، اطلاعات اعتبار شامل URI سرور Exchange، نام کاربری، رمز عبور و دامنه را از فرم ویندوز دریافت می‌کنیم. این یک نمونه بسیار ساده است، بنابراین ویژگی‌های پیام — موضوع، فرستنده و گیرنده — به‌سادگی در لیست‌باکس نمایش داده می‌شوند.

Exchange : مثال‌های کد

کد زیر را به هندلر کلیک دکمه List Messages اضافه کنید.

Exchange : خروجی

این اسکرین‌شات پیام‌های دریافت شده از سرور Exchange را نشان می‌دهد. متد ListMessages() اطلاعات پایه‌ای مانند موضوع، فرستنده، گیرنده و شناسه پیام را برمی‌گرداند. برای دریافت پیام کامل، متد ExchangeClient.SaveMessage() را فراخوانی کنید. (استفاده از ExchangeClient.SaveMessage() در مقاله توضیح داده شده است ذخیره پیام‌ها از صندوق پست سرور Exchange به فرمت EML و MSG.)

Aspose.Email.Mime

Multipurpose Internet Mail Extensions (MIME) یک استاندارد اینترنتی است که قالب ایمیل را برای پشتیبانی از متن در مجموعه کاراکتری غیر از US-ASCII، پیوست‌های غیرمتنی، بدنه‌های چندبخشی پیام و اطلاعات سرآیند در مجموعه کاراکتری غیر ASCII گسترش می‌دهد. Aspose.Email.Mime پروتکل MIME را بر روی چارچوب‌های .NET پیاده‌سازی می‌کند. این کتابخانه مانند یک مترجم عمل می‌کند؛ زیرا می‌تواند ایمیل را از فایل (.eml و غیره) یا از حافظه (رشته) بخواند. سپس فایل ایمیل یا رشته را به بخش‌های معنادار تجزیه می‌کند. اگر می‌خواهید بدون درگیر شدن با جزئیات پروتکل MIME به یک فایل ایمیل پرداخته و مثلاً پیوست‌ای را استخراج کنید، از Aspose.Email.Mime استفاده کنید.

ویژگی‌های اصلی

Aspose.Email.Mime به‌خوبی با Aspose.Email.Pop3 و Aspose.Email.Mail کار می‌کند.

Aspose.Email.Pop3 پیام‌های ایمیل را از یک صندوق پستی مشخص بازیابی می‌کند.
Aspose.Email.Mail پیام‌های ایمیل را به یک صندوق پستی مشخص ارسال می‌کند.
Aspose.Email.Mime محور اصلی دو مورد بالا است و پیام‌های ایمیل را تجزیه می‌کند.

Net: لغو درخواست‌های جلسه با تقویم

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

می‌توانید با استفاده از شیء کلاس Appointment در Aspose.Email یک درخواست لغو جلسه ارسال کنید. برای لغو درخواست به اطلاعات اصلی درخواست جلسه نیاز دارید. مثال در این مقاله ابتدا یک درخواست جلسه ارسال می‌کند، اطلاعات را در پایگاه داده ذخیره می‌کند و سپس درخواست را بر پایه شناسه پیام لغو می‌کند.

ارسال درخواست‌های جلسه

قبل از اینکه بتوانیم لغو درخواست‌های جلسه، ما باید برخی را ارسال کنیم:

ابتدا یک نمونه از نوع SmtpClient برای ارسال پیام ایجاد کنید.
برای جمع‌آوری اطلاعات شرکت‌کنندگان، یک دیتاگراید ایجاد کرده‌ایم تا کاربران بتوانند نام‌ها و آدرس‌های افرادی که دعوت‌نامه برایشان ارسال می‌شود را وارد کنند.
پس از انجام حلقه for-each بر روی مجموعه Rows جدول، تمام اطلاعات شرکت‌کنندگان را در مجموعه MailAddressCollection ذخیره کنید.
یک نمونه از کلاس MailMessage و ویژگی‌های ضروری مانند From، To و Subject ایجاد کنید.
یک نمونه از نوع Appointment ایجاد کنید و اطلاعات مکان، زمان شروع، زمان پایان، سازمان‌دهندگان و شرکت‌کنندگان را تعیین کنید.
تمام اطلاعات را در پایگاه داده SQL Server ذخیره کنید. کارهای مربوط به دیتابیس در متد SaveIntoDB انجام می‌شود.

قطعه کد زیر نشان می‌دهد چگونه درخواست‌های جلسه ارسال شود.

لغو درخواست جلسه

برای لغو درخواست جلسه، ابتدا شناسه پیام ایمیل را دریافت کنید. از آنجا که این اطلاعات را برای این مثال در دیتابیس ذخیره کرده‌ایم، به راحتی می‌توانیم دوباره آن را برداریم. ما از یک جدول برای بارگذاری تمام پیام‌های ارسال شده استفاده کرده‌ایم. اسکرین‌شات فرم به شرح زیر است:

انتخاب ردیفی که برای آن درخواست لغو ارسال شود.
Send Cancel Request را کلیک کنید تا درخواست ارسال شود.
کد شناسه را از ردیف انتخاب شده جدول دریافت می‌کند و دیتابیس را برای دریافت اطلاعات مربوط به شرکت‌کننده، پیام و تقویم جستجو می‌کند.
یک نمونه از کلاس Calendar ایجاد کنید و MailMessage کلاس‌ها با استفاده از اطلاعات دریافت شده از پایگاه داده.
از متد Appointment.CancelAppointment() برای ارسال درخواست لغو استفاده کنید.
ارسال ایمیل با استفاده از SMTP.

قطعه کد زیر نشان می‌دهد چگونه درخواست جلسه را لغو کنید.

Net: اولین برنامه با Aspose.Email.Outlook

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

این بخش نشان می‌دهد چگونه از Aspose.Email.Mapi. ما یک برنامه کوچک می‌سازیم که فایل پیام Outlook (TestMessage.msg) را بارگذاری کرده و موضوع، آدرس‌های فرستنده و گیرنده و محتوای بدنه را بر روی یک فرم ویندوز نمایش می‌دهد. برای ایجاد اولین برنامه خود با استفاده از Aspose.Email.Outlook این مراحل را دنبال کنید.

در Visual Studio، از منوی File گزینه New و سپس Project را انتخاب کنید.
انتخاب کنید که برنامه ویندوزی C# یا VB.NET ایجاد کنید.
با کلیک راست بر روی Reference در Solution Explorer، DLL Aspose.Email را به برنامه وارد کنید. این یک برنامه مبتنی بر ویندوز خواهد بود که تنها اطلاعات موجود در فایل پیام را نمایش می‌دهد.
یک نمونه از MapiMessage کلاس با ارائه مسیر فایل پیام.
از ویژگی‌های عمومی برای نمایش موضوع، فرستنده، گیرنده و بدنه بر روی کنترل‌های ویندوز استفاده کنید.

اجرای مراحل فوق در کد زیر نشان داده شده است. از کد زیر پس از کلیک دکمه Load Msg File یا در رخداد OnLoad فرم‌ها استفاده کنید.

Net: استخر اتصال بازنگری شد

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

با انتشار Aspose.Email 19.3، استخر اتصال بازنگری شد. جدید EmailClient کلاسی معرفی شده است که در نهایت جایگزین CredentialsByHostClient کلاس. EmailClient کلاس یک ConnectionAsgmtMode ویژگی که حالت تخصیص اتصال را در محیط چندرشته‌ای تعریف می‌کند. EmailClient.ConnectionAsgmtMode با استفاده از ConnectionAsgmtType قابل شمارش.

انواع اتصال

سه نوع اتصال زیر وجود دارد:

اتصال اصلی: این اتصال همراه با کلاینت ایمیل ساخته و حذف می‌شود. نمی‌تواند به‌صورت دستی ساخته یا حذف شود.
اتصال پیش‌فرض: کاربر می‌تواند اتصالات پیش‌فرض برای رشته‌ها با CreateConnection متد. اگر اتصال پیش‌فرض وجود داشته باشد، تمام متدهای کلاینت ایمیل که در یک رشته اجرا می‌شوند، به‌صورت ضمنی از این اتصال استفاده می‌کنند. فقط یک اتصال پیش‌فرض می‌تواند برای هر رشته وجود داشته باشد. می‌تواند به‌صورت دستی یا خودکار ایجاد شود. این بسته به ویژگی EmailClient.ConnectionAsgmtMode است. این اتصالات می‌توانند به‌صورت دستی با EmailClient.CreateConnection(createAsDefaultConnection = true) متد. اگر اتصال پیش‌فرض استفاده نشود (بسته به حالت تخصیص اتصال)، اتصال اصلی به‌صورت ضمنی به جای آن استفاده می‌شود.
اتصالات مستقل: این‌ها اتصالی هستند که به رشته‌ها لینک نمی‌شوند. می‌توانند به‌صورت دستی ایجاد شوند و باید به‌صورت صریح به‌عنوان پارامتر متد استفاده شوند. این اتصالات می‌توانند به‌صورت دستی با EmailClient.CreateConnection() متد یا EmailClient.CreateConnection(createAsDefaultConnection = false) متد.

انواع تخصیص اتصال

برای تنظیم EmailClient.ConnectionAsgmtMode ویژگی، ConnectionAsgmtType قابل شمارش استفاده می‌شود. انواع تخصیص ارائه شده توسط ConnectionAsgmtType در زیر فهرست شده‌اند.

ConnectionAsgmtType.UseMainOrDefault: این حالت به‌صورت پیش‌فرض در مشتریان ایمیل استفاده می‌شود. مشتری ایمیل از اتصال اصلی برای تمام عملیات از چندین رشته استفاده می‌کند اگر اتصال پیش‌فرض ایجاد نشده باشد، یا اگر اتصال به‌صورت صریح به عنوان پارامتر متد ارسال نشده باشد. اتصال اصلی اتصالی است که همزمان با ایجاد مشتری ایمیل ساخته می‌شود. کاربر می‌تواند اتصالات پیش‌فرض برای رشته‌ها با CreateConnection متد. اگر اتصال پیش‌فرض برای یک رشته ایجاد شود، به‌صورت ضمنی برای تمام متدهای کلاینت ایمیل که در این رشته فراخوانی می‌شوند، استفاده می‌شود. اگر اتصال پیش‌فرض برای یک رشته ایجاد نشده باشد، اتصال اصلی برای تمام متدهای کلاینت ایمیل که در این رشته فراخوانی می‌شوند، استفاده می‌شود. کاربر همچنین می‌تواند اتصالاتی که به رشته‌ها لینک نشده‌اند (اتصالات پیش‌فرض نیستند) را با استفاده از CreateConnection متد. اگر کاربر بخواهد از اتصالات دیگر (نه اصلی و نه پیش‌فرض) استفاده کند، باید این اتصال را به‌صورت صریح به‌عنوان پارامتر متدی که می‌خواهد استفاده کند، پاس بدهد. کاربر می‌تواند به‌طور اضافی هر تعداد اتصال ایجاد کند. اتصال پیش‌فرض فقط می‌تواند برای هر رشته یک‌بار وجود داشته باشد. لطفاً توجه داشته باشید که اتصالات پیش‌فرض اگر کاربر از اشیاء Thread برای برنامه‌نویسی چندوظیفه‌ای استفاده کند درست کار می‌کنند. اگر کاربر از ConnectionPool یا از اشیاء Task برای برنامه‌نویسی چندوظیفه‌ای استفاده کند، این حالت ممکن است منجر به رفتار نادرست برنامه شود. برای جلوگیری از این مشکل، کاربر باید در پایان اجرای کد (اگر از آن استفاده می‌کند) اتصال پیش‌فرض را به‌صورت دستی آزاد کند.
ConnectionAsgmtType.UseMain: مشتری ایمیل از اتصال اصلی برای تمام عملیات از چندین رشته استفاده می‌کند. اتصال اصلی اتصالی است که همزمان با ایجاد مشتری ایمیل ساخته می‌شود. کاربر نمی‌تواند اتصالات پیش‌فرض ایجاد کند. کاربر می‌تواند اتصالاتی که به رشته‌ها مرتبط نیستند (اتصالات غیر پیش‌فرض) را با CreateConnection متد. اگر کاربر بخواهد از اتصالات دیگر (نه اصلی و نه پیش‌فرض) استفاده کند، باید این اتصال را به‌صورت صریح به‌عنوان پارامتر متدی که می‌خواهد استفاده کند، پاس بدهد.
ConnectionAsgmtType.UseDefault: مشتری ایمیل به‌صورت ضمنی فقط از اتصالات پیش‌فرض برای تمام عملیات از چندین رشته استفاده می‌کند. در این حالت اتصال اصلی استفاده نمی‌شود. اگر اتصال پیش‌فرض برای برخی رشته‌ها (در اولین فراخوانی متد مشتری ایمیل) ایجاد نشده باشد، مشتری ایمیل به‌صورت ضمنی برای آن رشته یک اتصال پیش‌فرض قبل از اجرای اولین عملیات ایجاد می‌کند. کاربر نمی‌تواند اتصالات پیش‌فرض برای رشته‌ها با CreateConnectionمتد زیرا به‌طور خودکار ایجاد می‌شوند. وقتی اتصال پیش‌فرض برای یک رشته ایجاد می‌شود، به‌صورت ضمنی برای تمام متدهای کلاینت ایمیل که در این رشته فراخوانی می‌شوند، استفاده می‌شود. کاربر همچنین می‌تواند اتصالاتی که به رشته‌ها لینک نشده‌اند (اتصالات پیش‌فرض نیستند) را با استفاده از CreateConnectionمتد. اگر کاربر بخواهد از اتصالات دیگر (نه اصلی و نه پیش‌فرض) استفاده کند، باید این اتصال را به‌صورت صریح به‌عنوان پارامتر متدی که می‌خواهد استفاده کند، پاس بدهد. کاربر می‌تواند به‌طور اضافی هر تعداد اتصال ایجاد کند. فقط یک اتصال پیش‌فرض می‌تواند برای هر رشته استفاده شود. لطفاً توجه داشته باشید که اتصالات پیش‌فرض اگر کاربر از اشیاء Thread برای برنامه‌نویسی چندوظیفه‌ای استفاده کند درست کار می‌کنند. اگر کاربر از ConnectionPool یا از اشیاء Task برای برنامه‌نویسی چندوظیفه‌ای استفاده کند، این حالت ممکن است منجر به رفتار نادرست برنامه شود. برای جلوگیری از این مشکل، کاربر باید در پایان اجرای کد به‌صورت دستی اتصال پیش‌فرض را آزاد کند.