Добавяне и изтриване на файлове, свързани с перспективите за надстройка, Microsoft документи

В тази статия,

addFileAttachmentAsync addItemAttachmentAsync и методи могат да бъдат използвани, за да прикачите Outlook и елемент на елемент, който създава на потребителите. И двете от тези методи са асинхронни, т.е.. Е. Те могат да бъдат изпълнени, без да чака приключването на действията добавка за свързване. В зависимост от началото местоположение и размера на прикачените файлове, за да завърши асинхронни повикване добавка привързаност може да отнеме известно време. Ако някои задачи са в зависимост от приключването на дейността, те трябва да се направи в метода за обратно повикване. Това е незадължителен метод, който се нарича след приключване на изпращане на прикачени файлове. Това отнема AsyncResult обект като продукция параметър, което представлява състояние грешка и стойността на връщане на действие добавка закрепване. Ако обратното повикване изисква допълнителни параметри, които могат да използват незадължителния параметър options.aysncContext. options.asyncContext може да бъде от всякакъв тип, които ще обратно повикване метод.

Например, може да се определи как options.asyncContext JSON обект, включващ един или повече двойки "ключ-стойност", където символът ":" разделя ключа и стойността и символи "," разделени двойки помежду си. Други примери за избираеми параметри в методите за предаване за асинхронни Офис платформа надстройка виждат. Член асинхронно програмиране в офис надстройки. Следващият пример показва как да използвате параметър asyncContext за предаване на два аргумента метод за обратно повикване.

Успехът на метода на асинхронен обаждане може да бъде проверена с свойствата и състояние за грешка AsyncResult обекта. Ако операцията е успешна инвестиция, можете да използвате AsyncResult.value собственост. за да получите идентификатор инвестиции. Това е цяло число, което може да се използва в бъдеще, за да премахнете прикачения файл.

Забележка. Препоръчваме ви да използвате приложенията за самоличност, за да го премахнете, само ако същото добавите добавена инвестицията в една и съща сесия. В Outlook Web App и OWA за идентификатор прикачено устройство е валиден само в една и съща сесия. Сесията завършва, когато потребителят затвори надстройката или започва да се създаде елемент във вътрешната форма, а след това продължава в отделен прозорец.

Прикачването на файл

Можете да прикачите файл към съобщение или на среща под формата на създаване, се използва метод addFileAttachmentAsync като уточни URI файла. Ако даден файл е защитен, можете да добавите съответния сертификат или код за разпознаване като заявка низ параметър URI. Exchange ще накара URI, за да получите прикачен файл, и уеб услуга, която защитава файла ще трябва да използвате маркера за удостоверяване.

Поставяне на елемент на Outlook

Можете да прикачите елемент на Outlook (например електронна поща, календар или т контакт) на съобщението или на срещата под формата на създаване, като посочва елемент идентичност в Web Services борсовите (СРП) и причиняване метод addItemAttachmentAsync. Можете да получите EWS идентификатор за даден елемент, календар, контакти, или задача в пощенската кутия на потребителя, причинявайки mailbox.makeEwsRequestAsync метод на работа и използването на EWS FindItem. item.itemId имот също така предоставя EWS идентификатор на съществуващ елемент под формата на четене.

Забележка. В Outlook Web App, или OWA да създаде добавка на устройства, може да се използва за свързване на инстанция на повтарящ се среща. Въпреки това, в Outlook богати клиенти се опитват да приложат копие от прикачения файл ще доведе до по брой повторения (основна среща).

Изтриване на прикачени файлове

Можете да премахнете прикачен файл от елемент на съобщението или на срещата под формата на създаване, като посочва съответните прикачени файлове идентификатор и причиняване метод removeAttachmentAsync. Необходимо е да се премахне само приложенията, които са добавени към една и съща надстройката в една и съща сесия. Трябва да се гарантира, че идентификаторът да съответства на действителното инвестиращи, в противен случай методът се връща грешка. Техниките и addFileAttachmentAsync addItemAttachmentAsync. removeAttachmentAsync е асинхронен метод. Трябва да посочите метод за обратно повикване, за да проверите състоянието и грешки, като се използват AsyncResult изходен параметър обект. допълнителни параметри също могат да бъдат предадени на метода за обратно повикване с помощта на незадължителен параметър asyncContext. който е обект на JSON, състояща се от двойки "ключ-стойност."

Съвети за добавяне и изтриване на прикачени файлове

Ако вашата добавка създаване добавяте или премахвате прикачени, образуват код за предаване на валидно приспособления за самоличност, когато се обадите за премахване-прикачения файл и се справят с възможен вариант, при AsyncResult.error връща InvalidAttachmentId. В зависимост от местоположението и размера на инвестициите, за да завършите операцията по присъединяване може да отнеме известно време. Следващият пример ще поддържа методите на повикване addFileAttachmentAsync. пишат и removeAttachmentAsync. Можем да предположим, че те се извършват последователно.

Тъй като метод addFileAttachmentAsync е асинхронен, че въпреки факта, че addFileAttachmentAsync извършва преди removeAttachmentAsync. removeAttachmentAsync призовава и пишат може да се проведе докрай addFileAttachmentAsync. Когато това се случи, attachmentID остава неопределено. и се появи грешка за removeAttachmentAsync на повикване, както е показано по-долу:

Един от начините да се предотврати това - уверете се, attachmentID настроен преди да се обадите removeAttachmentAsync. Друг метод - метод, който да доведе до removeAttachmentAsync обаждане addFileAttachmentAsync. като в следния пример:

Следното е пример на изходните данни: