Documentation – Технически статии

Net: Защо Aspose.Email

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

Net: Сравнение на Aspose.Email.Mail с MS API

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

Сравнение на Aspose Email Mail с MS API

System.Web.Mail е просто обвивка около две 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.

Тези особености правят отстраняването на проблеми много по-трудно, особено при прехвърляне на код към различни операционни системи. Приложението може да получава неочаквани резултати на различни ОС. 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
Зареждане от формат Microsoft Msg	X
Зареждане от формат Microsoft Mht	X
Запис в формат Microsoft 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 и четете имейлите си от множество компютри, искате да оставите имейлите на сървъра, за да са достъпни по всяко време. Ако не оставите имейлите на сървъра, цялата поща във вашата папка Inbox ще се изтегли на компютъра, който използвате в момента. Ако четете пощата си само от едно място, няма нужда да оставяте имейлите на сървъра. Ще видите инструкции как да зададете тази опция, докато преминавате през стъпките за настройка на вашата имейл програма.

Защо да изберете IMAP вместо POP3 и да оставате имейлите на сървъра? С POP3 вашите имейл съобщения са само на сървъра, но с IMAP вашите имейл папки също са на сървъра.

Net: Достъп до Gmail чрез SSL

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

SMTP

Тази статия показва как да се извърши свързване към Gmail сървър и изпращане на имейл използвайки SMTP протокола върху SSL.

Свързване към Gmail SMTP сървър

Следният фрагмент от код показва как да се свържете със SMTP сървър, поддържащ SSL.

Изпращане на имейл съобщение

Горният код създава SMTPClient обекта, за да се свърже към Gmail сървъра. За да изпратите съобщение чрез същия клиентски обект, създайте MailMessage класов обект и изпращане на съобщението чрез SMTP клиент обекта. Следният фрагмент от код показва как да зададете свойствата на съобщението, например subject, to и body:

IMAP

Тази статия показва как да изпълните редица дейности на SSL‑поддържан пощенски сървър, използвайки IMAP протокола:

Свържете се с пощенски сървър.
Получете общия брой съобщения във входящата кутия.
Запазете съобщенията локално.
Създайте съобщение и го добавете в папка.

Свързване към пощенския сървър

Използвайте Aspos.Email ImapClient класов обект за свързване към пощенския сървър. Необходими са адресът, портът, потребителското име и паролата на сървъра, за да се установи връзка. Gmail използва порт 993 за IMAP протокола, следният фрагмент от код показва как се свързва към Gmail чрез този порт.

Избиране на папка и получаване на общия брой съобщения

Проверка на папка Inbox е най-честа задача при проверка на имейл. С Aspose.Email това може да се направи с два прости реда код. Следният фрагмент от код показва как да получите достъп до папка Inbox и да изчислите общия брой съобщения в папката.

Записване на съобщенията на локален твърд диск

След като папка бъде избрана с метода SelectFolder, използвайте функцията ListMessages, за да получите списък от всички съобщения в папката в обект ImapMessagesInfoCollection. Обхождайте тази колекция и запазвайте имейл съобщенията на локалния диск на компютъра, както следва:

Създаване на нова папка

IMAP протоколът също позволява създаване на нова папка на имейл сървъра. Това може да се направи с просто извикване на функция.

Създаване на ново съобщение в папка

Добавете ново съобщение към папката, използвайки MailMessage и ImapClient класове. Примерите по-долу първо създават обект MailMessage, като предоставят стойностите за subject, to и from. След това се абонират за папка и добавят съобщението към нея. Следният фрагмент от код показва как да създадете ново съобщение в папка.

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‑рият.

Повтарящите се модели обикновено са периодични, но не е задължително. Повтарящият се модел може напълно да се опише като набор от предварително дефинирани дати и часове на появяване. RFC‑ът iCalendar определя компоненти, като 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, първата седмица от годината е тази, която съдържа поне четири дни. Когато годината започва в събота, например, седмица 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 с местно време

Датата с местно време е просто стойност date-time, която не съдържа обозначението UTC и не се отнася към часова зона. Например, следното представлява 18 януари 1998 г. в 23:00: DTSTART:19980118T230000. Стойностите от този тип се наричат „плаващи“ и не са свързани с конкретна часова зона. Те се използват, за да представляват еднакви час, минута и секунда независимо от наблюдаваната в момента часова зона.

DATE-TIME с UTC време

Дата с UTC време, или абсолютен час, се обозначава със суфикс – латинска главна буква Z, указваща UTC, добавена към стойността на часа. Например, следното представлява 19 януари 1998 г., 07:00 UTC: DTSTART:19980119T070000Z. Обърнете внимание, че Aspose.iCalendar игнорира суфикса Z и третира часа като местно време. Стандартът 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 Document Library

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

Тази статия показва как да четете имейл съобщения от Microsoft SharePoint документна библиотека. За достъп до файлове в SharePoint документна библиотека, трябва да бъде инсталиран SharePoint SDK на системата. SDK предоставя необходимия API за влизане и достъп до файлове от библиотеката.

Четене на имейл съобщения от SharePoint

Програмните примери по-долу приемат, че Microsoft Outlook Message файл (.msg) вече е съхранен в папката SharedDocument на SharePoint Document Library. SharePoint SDK се използва, за да вземе файла със съобщението в поток и след това да предаде този поток към инстанция от Aspose.Email MailMessage клас. Класът MailMessage зарежда потока и парсира Outlook файл със съобщение. След това достъпете свойствата на класа MailMessage, например, subject, text body, HTML body и т.н., за да използвате информацията в проект във Visual Studio. За информация как да инсталирате и конфигурирате Microsoft SharePoint Server и SDK, моля, прегледайте съответните раздели в MSDN библиотеката. Следният фрагмент от код показва как да четете имейл съобщения от SharePoint.

Net: Задаване на кодиране по подразбиране за текст в имейл съобщение

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

Тази статия представя MailMessage.PreferredTextEncoding свойство и обяснява как се използва. С това свойство можете да зададете кодиране по подразбиране за следните свойства:

От: Показвано име
До: Показвано име
Subject
Тяло

Задаване на кодиране по подразбиране за текст

В предишни версии на Aspose.Email, кодировката на текста за свойства от, до, тема и тяло се задаваше отделно. За подобряване на удобството, добавихме 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 Message файл (MSG) в TIFF изображение.

Net: Използване на Microsoft Word документ като тяло на съобщение и изпращане на имейл

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

Тази статия показва как да използвате Microsoft Word документ като тяло на имейл и да го изпратите до получатели. Примерният документ е продажбена фактура от примерната база данни Northwind, експортирана в формат Microsoft Word. Aspose.Email за .NET се занимава с мрежови протоколи и функции на Microsoft Outlook и не може да работи с 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 to 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 работна книга като тяло на имейла и я изпраща до получателите. Aspose.Email за .NET се занимава с мрежови протоколи и функции на Microsoft Outlook и не може да работи с Excel работни книги. За да се преодолее това, примерите в тази статия използват Aspose.Cells за .NET, за да заредят Excel работната книга и я конвертират в HTML поток. Aspose.Email за .NET след това използва HTML потока като тяло на имейла. Примерният код показва как да изпратите лист от Excel като тяло на имейл, използвайки Aspose.Cells за .NET и Aspose.Email за .NET.

Зареждане на Microsoft Excel работна книга, използвайки класа 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

Клас‑обвивка за зареждане на имейл съобщения

Има редица случаи, в които е желателно да се има функционалност за таймаут, за да се прекъсне действие, което отнема ненужно дълго време. Тази статия предоставя примерен клас за реализиране на таймаут функционалност при зареждане на файлове EML/MSG, което може да доведе до много дълги забавяния или провали при зареждане. Тъй като таймаутът не е пряко свързан с операции по четене/запис на диск или мрежа, е по-полезно да се реализира тази функция от страната на потребителя, като се напише клас‑обвивка около Aspose, вместо да се интегрира в API‑то.

Отмяната на дълго изпълняващ се нишка може да се постигне чрез използване на обвивка‑делегат, който предава нишката, която трябва да бъде убита, в локална променлива в метода, който я е стартирал. Дълго изпълняващата се нишка се отменя чрез прекъсването й и контролът се връща към главното приложение. Следният примерен код предоставя примерен клас‑обвивка около библиотеката Aspose.Email. Кодът показва пример за употреба на класа‑обвивка.

Пример за програмиране с .NET 3.5 и по-нови

Пример за програмиране с .NET 2.0

Пример за употреба

Net: Генериране на повторения от шаблон за повтаряне

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

С Aspose.Email е възможно да се генерират събития, използвайки шаблон за повторение. Тази статия обяснява как, как да генерирайте следващото събитие и получете удобни за потребителя описания на елементите. Събития от шаблон за повтаряне в MAPI календар могат да се генерират с помощта на Aspose.Email. Следният кодов фрагмент ви показва как да генерирате събития от шаблони за повторение.

Изчисляване на следващото събитие или n следващи събития

За да получите следващото ("next") повторение, използвайте метода GenerateOccurrences с параметъра nNextOccurrences=1. Следният фрагмент от код показва как да генерирате 20 повторения, като използвате nNextOccurrences = 20. Резултатът от кода по-долу е следният:

Получаване на потребителски приятелски текст за повтаряне

Потребителски приятелски текст за правило може да се получи, използвайки свойството FriendlyText, както е показано по-долу. Изходът от кода ще бъде: "Повтаря се всеки месец на 1‑ви и 1‑ви от края на ден(дните) на месеца за максимум 2 повторения.". Следният кодов откъс показва как да се получи потребителски приятелски текст за повтаряне.

Net: Достъп до имейл услуги с OAuth

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

Поддръжка за OAuth 2.0 е добавена към Aspose.Email и може да се използва за достъп до сървъри SMTP, POP3, IMAP и EWS. По принцип всички сървъри, поддържащи токени тип OAuth 2.0, могат да се използват с Aspose.Email, но нашите имейл клиенти са тествани с пощенските сървъри на Google и Microsoft Office 365. Достъпът до сървъра от SmtpClient, Pop3Client, ImapClient и EWSClient с OAuth може да се реализира по 2 начина.

Предоставете токен за достъп директно в конструктора на имейл клиента. В този случай потребителят трябва да разбира, че срокът на валидност на токените за достъп е ограничен. Когато токенът изтече, имейл клиентът не може да се използва за достъп до сървъра.
Предоставете персонализирана имплементация на доставчик на токени, базирана на ITokenProvider интерфейс в конструктора на имейл клиента. В този случай клиентът проверява времето на изтичане на токена и изпраща заявка за ITokenProvider за нов токен за достъп, когато предишният изтече. По този начин клиентът обновява токените периодично и може да работи със сървъра неограничено време. Често услугите поддържат прост начин за обновяване на токените за достъп. Например, използването на токени за обновяване в услугите на Google или ROPC поток за удостоверяване в Microsoft идентификационната платформа може да се използва за реализиране на доставчик на токени.

Конфигурирайте акаунт на съответния сървър

Следващите статии ви помагат да конфигурирате акаунти за достъп до имейл услуги.

За 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))
{

}

Имплементация на персонализиран 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: Различаване между вградени и обикновени прикачени файлове

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

Често се случва имейл съобщението да съдържа вградени изображения в тялото си, както и обикновени прикачени файлове, свързани с него. Използвайки MailMessage клас, вградени прикачени файлове могат да бъдат извлечени от LinkedResourceCollection клас, докато обикновените прикачени файлове могат да бъдат достъпни/извлечени с AttachmentCollection клас на съобщение. Въпреки това, това е различно, когато съобщението се зарежда чрез класа Aspose.Email.Mapi.MapiMessage, тъй като всички вградени изображения и обикновени прикачени файлове са достъпни за потребителя в същия клас MapiAttachmentCollection. Следователно е необходимо да се разработи метод, който да различава вградения и обикновения прикачен файл, когато се използва MapiMessage.

Използване на Aspose.Email за различаване между вградени и обикновени прикачени файлове

Тази статия обяснява как да се различат вградените прикачени файлове от обикновените с помощта на MapiMessage. За да се определи това различие, типът на тялото на MapiMessage се взема предвид, както следва:

Текстово тяло: Имейл съобщения с тип тяло plain text не се нуждаят от проверка, тъй като всички прикачени файлове в такива съобщения винаги са обикновени.

Html тяло: При съобщение с HTML тип тяло, прикаченият файл трябва не само да съдържа свойството PR_ATTACH_FLAGS (0x37140003), но стойността му също трябва да е 0x00000004 за вградени прикачени файлове. Ако това условие е изпълнено, тогава се взема предвид и теглата PR_ATTACH_CONTENT_LOCATION и PR_ATTACH_CONTENT_ID за определяне на естеството на прикачения файл. Въпреки това, при липса на PR_ATTACH_FLAGS Mapi таг, прикаченият файл се проверява за свойството PR_ATTACH_DISPOSITION (0x3716001F или 0x3716001E) за определяне типа на прикачения файл.

Rtf тяло: Ако тялото е RTF, тогава всички OLE прикачени файлове са вградени. Стойността на PR_ATTACH_METHOD за всички OLE прикачени файлове е 0x00000006.

Следният примерен код демонстрира програмно различаване между вградени и обикновени прикачени файлове. Функцията IsInlineAttachment приема прикачен файл и тип на тялото на съобщението като входни параметри и връща true, ако прикаченият файл е вграден.

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 клас за изброяване на 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, т.е. само вградените изображения в съобщението ще бъдат част от 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 клиентът създава 1 връзка, извършва автентикация и упълномощаване. Тази връзка остава в работно състояние, докато клиентът не бъде освободен. Всички операции от различни нишки се насочват към една опашка от команди, поставена в главната връзка.

2. При MaxConnectionsPerServer > 1 клиентът създава необходимия брой връзки, извършва автентикация и упълномощаване за всяка връзка. Една връзка се запазва като главна връзка. Тази връзка остава в работно състояние, докато клиентът не бъде освободен. Всички останали връзки се създават и освобождават при нужда. Максималният брой такива връзки се определя от свойството MaxConnectionsPerServer, т.е. например ако MaxConnectionsPerServer = 2, една се запазва като главна връзка, а втората се използва като допълнителна за операции, изпълнявани в други нишки. По същия начин, ако MaxConnectionsPerServer = 3, първата връзка е главна, а две други се използват като допълнителни за операции в други нишки. Ако дойде нова заявка за връзка от нова нишка и всички връзки вече са заети, клиентът изчаква, докато броят на използваните връзки не се намали. Това е много важен момент, който обяснява защо правилното освобождаване на връзките е толкова важно.

Примери

Потребителят може да изпълнява операции в различни нишки по няколко начина. Те могат да се разделят на два типа:

1. Потребителят използва асинхронни (Begin/End) методи, определени в клиента. В този случай имейл клиентът създава нови нишки при необходимост. В клиента е реализирана опашка от задачи (моля, не се бъркайте с опашката от команди във връзката). Задачата може да се изпълни, ако връзката е налична. Когато броят на използваните връзки стане по-малък от лимита, клиентът създава нова връзка, създава нишка за текущата задача и я изпълнява. Пример за използване на асинхронни операции:

2. Потребителят може да създава нишки, използвайки обекти като Thread, ThreadPool, Task или други обекти за тази цел. Също така потребителят може да използва нишки, създадени в трети страни код. По време на това клиентът има два модела на поведение

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 бюлетини, включващи изображения (и други вградени обекти). С функцията за масова поща на Aspose.Email.Mail API е също възможно да се изпратят огромни масови имейли за ограничено време. Aspose.Email.Mail също предоставя функция за съчетаване на поща, базирана на шаблони, която може да се използва за създаване на шаблон за бюлетин. Шаблонът за бюлетин може да се използва за изпълнение на съчетаване на поща при изпращане на масови бюлетини. Има много други възможни задачи, които Aspose.Email.Mail може да изпълни в приложение за имейл маркетинг.

Други маркетингови инструменти

Подобно на приложения за бюлетини, с Aspose.Email.Mail могат да се изграждат и много други типове софтуер. Използвайте го за създаване на имейл маркетинг, масови разпространения и e‑campaign масови изпратения, и др.

Бизнес приложения

Aspose.Email.Mail може да се използва почти във всички видове бизнес приложения за извършване на помощни задачи:

Имейл известия: Изпращайте имейл известия, за да информирате потребителите за активности.
Искания за срещи: Изпращайте бизнес искания за срещи, използвайки поддръжката на iCalendar в Aspose.Email.Mail.
Имейл с планирани справки: Справките са неразделна част от повечето бизнес приложения. Много бизнес справки се генерират периодично. Използвайте Aspose.Email.Mail за изпращане на планирани справки по имейл.

Имейл клиенти

Aspose.Email.Mail може да се използва и в имейл клиенти за изпращане на обикновени имейли. Той поддържа прикачени файлове, вградени обекти, iCalendar събития, съчетаване на поща (mail merge), изпращане на масови имейли и др., така че 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. (Изберете дали да създадете C# или VB.NET Windows приложение).
Ако имате лиценз, приложете го, за да използвате пълната версия на 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 е много мощен компонент, с който разработчиците могат да изпълняват почти всички имейл задачи, като изпращане на многопоточни масови имейли, използване на mail merge, добавяне на прикачени файлове, вграждане на снимки и звуци в имейл съобщения, добавяне на iCalendar събития към имейли, получаване на имейли и много други.

Aspose.Email.Pop3

Aspose.Email.Pop3 реализира протокола Post Office Protocol v3 (POP3) в .NET framework. Той позволява на .NET разработчиците да добавят функции за заявка и получаване на имейли към техните .NET приложения, без да се захващат в детайли на протокола и сложността на имейл и мрежово програмиране. Aspose.Email.Pop3 поддържа всички команди, дефинирани в стандартния POP3 протокол, и предоставя лесни за използване интерфейси с компактен и интуитивен обектен модел. Това значително намалява типичната крива на обучение за .NET разработчиците.

Pop3 : Основни функции

Като част от Aspose.Email, Aspose.Email.Pop3 е проектиран специално за .NET и е написан на управляван C# код. Той ви позволява да:

Свързване и влизане в POP3 сървъри.
Поддръжка на APOP.
Запитване за съобщения.
Извличане на съобщения.
Пълна поддръжка за асинхронен стил на програмиране.
Поддръжка на 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 Windows приложение.
Импортирайте 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 framework. Aspose.Email.Imap позволява на .NET разработчиците бързо да добавят IMAP възможности към своите .NET приложения, без да се налага да разбират детайлите на протокола. Компонентът поддържа изтегляне и качване на съобщения, проверка на състоянието ново/прочетено/непрочетено на съобщения и др.

Imap : Основни функции

Aspose.Email.Imap ви позволява да:

Извличане на имейл съобщения.
Качване на имейл съобщения.
Списък на имейл съобщения в различни папки.
Проверка на състоянието на имейл съобщенията.
Работа с MailMessage.
Работа с поддръжка на SSL.

Използване на Aspose.Email.Imap

Aspose.Email.Imap реализира Internet Message Access Protocol в .NET framework. С него разработчиците могат лесно да заявяват и управляват имейли на 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 Windows приложение.
Импортирайте 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 сървъри.
Списък на имейл съобщения в Exchange пощенски кутии.
Списък на имейл съобщения от различни папки, например Inbox, Sent, Deleted или Drafts.
Изтриване на съобщения във всяка папка на Exchange сървъри.

Използване на Aspose.Email.Exchange

С Aspose.Email.Exchange разработчиците могат да достъпват пощенски кутии на Exchange Server от своите .NET приложения. Тя предоставя лесен за използване API за управление на имейли в Exchange сървъри. Разработчиците могат да създават конзолни, настолни или уеб приложения, които управяват имейли в 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 форма. Това е много прост пример, затова свойствата на съобщението – тема, подател и получател – се показват просто в листбокса.

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 реализира протокола 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: Отменяне на заявки за среща с 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. Работата, свързана с БД, се извършва в метода 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: Пул за връзки преработен

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 за многозадачно програмиране, този режим може да доведе до неправилно поведение на приложението. За да се избегне този проблем, потребителят трябва ръчно да освободи подразбиращата се връзка в края на изпълнението на кода.

Documentation – Технически статии

Net: Защо Aspose.Email

Net: Сравнение на Aspose.Email.Mail с MS API

Сравнение на Aspose Email Mail с MS API

Специфики на SmtpMail

Матрица за сравнение

Net: Разлика между POP3 и IMAP

Разлика между POP3 и IMAP

POP3 и IMAP

POP3

IMAP акаунт

Оставяне на поща на сървъра срещу премахване на поща от сървъра

Net: Достъп до Gmail чрез SSL

SMTP

Свързване към Gmail SMTP сървър

Изпращане на имейл съобщение

IMAP

Свързване към пощенския сървър

Избиране на папка и получаване на общия брой съобщения

Записване на съобщенията на локален твърд диск

Създаване на нова папка

Създаване на ново съобщение в папка

POP3

Свързване към пощенски сървър

Проверка на състоянието на пощенската кутия

Проверка на информацията за съобщението

Извличане на съобщения

Net: Въведение в модели на повтаряне

За обектния модел Aspose.iCalendar

Примерни модели

Последният ден от месеца

Последният работен ден от всеки месец

Последният понеделник от годината

Петък от първата ISO 8601 седмица от годината

Първият петък от годината

Net: Важни детайли за iCalendar RFC 2445

За обектния модел Aspose.iCalendar

Важни детайли за iCalendar RFC 2445

Формати за дата и час

DATE

DATE-TIME с местно време

DATE-TIME с UTC време

DATE-TIME с местно време и часова зона

BYWEEKNO Осигурява съответствие с ISO 8601

Net: Парсиране на файлове от Microsoft Outlook

Net: Получаване на известия за успешно изпратени и неуспешни съобщения

Net: Откриване на нови имейл съобщения на POP3 сървър

Откриване на нови съобщения

Net: Четене на имейл съобщения от Microsoft SharePoint Document Library

Четене на имейл съобщения от SharePoint

Net: Задаване на кодиране по подразбиране за текст в имейл съобщение

Задаване на кодиране по подразбиране за текст

Net: Конвертиране на Outlook съобщение (MSG) в TIFF изображение

Net: Използване на Microsoft Word документ като тяло на съобщение и изпращане на имейл

Използване на Microsoft Word документи като тяло на имейл

Net: Функции за печатане на Aspose.Email

Функции за печат

Печатане на тялото на съобщението

Печатане на заглавките и тялото на съобщението

Печатане на съобщение с HTML тяло

Задаване на оформление на страницата за печат

Автоматично приспособяване на TIFF

Регулиране на целевото DPI за изходен TIFF

Net: Използване на лист от Microsoft Excel като тяло на съобщението и изпращане на имейл

Net: Клас-обвивка за асинхронно зареждане на имейл съобщения с използване на Aspose.Email

Клас‑обвивка за зареждане на имейл съобщения

Пример за програмиране с .NET 3.5 и по-нови

Пример за програмиране с .NET 2.0

Пример за употреба

Net: Генериране на повторения от шаблон за повтаряне

Изчисляване на следващото събитие или n следващи събития

Получаване на потребителски приятелски текст за повтаряне

Net: Достъп до имейл услуги с OAuth

Конфигурирайте акаунт на съответния сървър

Достъп до имейл услуги с токени за достъп

Достъп до имейл услуги с доставчиците на токени

Имплементация на персонализиран ITokenProvider за Office 365

Net: Различаване между вградени и обикновени прикачени файлове

Използване на Aspose.Email за различаване между вградени и обикновени прикачени файлове

Net: Изпращане на имейл чрез DNS

Петък от първата ISO 8601 седмица от годината

Пример за програмиране с .NET 3.5 и по-нови

Пример за програмиране с .NET 2.0