Adăugarea și ștergerea fișierelor atașate la perspectivele suprastructură, documente Microsoft

În acest articol,

addFileAttachmentAsync addItemAttachmentAsync și metode pot fi folosite pentru a atașa fișierul Outlook și pentru elementul care creează un utilizator. Ambele metode sunt asincrone, adică. E. Ele pot fi executate fără a aștepta finalizarea acțiunilor add-atașament. În funcție de locația de pornire și dimensiunea atașamentelor, pentru a finaliza apel add-atașament asincron poate dura ceva timp. În cazul în care unele sarcini depind de finalizarea acțiunii, acestea ar trebui să se facă în metoda de apel invers. Aceasta este o metodă opțională, care se numește după finalizarea trimiterii atașamentele. Este nevoie de AsyncResult ca obiect un parametru de ieșire, ceea ce reprezintă eroarea de stat și valoarea returnată a acțiunii add-atașament. Dacă callback necesită parametri suplimentari, ei pot folosi parametrul options.aysncContext opțional. options.asyncContext poate fi de orice tip, care va callback metoda.

De exemplu, se poate determina modul în care options.asyncContext JSON un obiect care cuprinde una sau mai multe perechi de „cheie-valoare“, unde simbolul „:“ separă cheia și valoarea, și simboluri „“ separate perechi între ele. Alte exemple de parametri opționali în metode de transmisie asincrone suprastructură Platform Oficiul vezi. Articolul asincronă Programarea în suprastructuri Office. Următorul exemplu arată cum se utilizează parametrul asyncContext pentru transmiterea a două argumente metoda de apel invers.

Succesul metodei de apel invers asincron poate fi verificată cu proprietățile și obiectul AsyncResult erori de stare. În cazul în care operațiunea este de investiții de succes, puteți utiliza AsyncResult.value de proprietate. pentru a obține identificatorul de investiții. Acesta este un număr întreg, care poate fi utilizat în viitor pentru a elimina atașamentul.

Notă. Vă recomandăm să utilizați atașamentele ID-ul pentru ao elimina, numai în cazul în care aceeași investiție add-a adăugat în aceeași sesiune. În Outlook Web App și OWA pentru identificatorul dispozitivului de fixare este valabil numai în aceeași sesiune. Sesiunea se încheie atunci când utilizatorul închide suprastructurii sau începe să creeze un element sub formă internă, și apoi se continuă într-o fereastră separată.

Atașarea unui fișier

Aveți posibilitatea să atașați un fișier la un mesaj sau o întâlnire sub formă de a crea, folosind metoda addFileAttachmentAsync și specificând fișierul URI. Dacă un fișier este protejat, puteți adăuga certificatul corespunzător sau token de autentificare ca parametru șir de interogare URI. Exchange va determina URI-ul, pentru a obține un atașament, și un serviciu web care protejează fișierul va trebui să utilizeze token-ul pentru autentificare.

Atașarea unui element Outlook

Aveți posibilitatea să atașați un element Outlook (de exemplu, e-mail, un element de calendar sau de contact) la mesaj sau întâlnirea sub forma de creare, specificând elementul de identitate în Web Services Exchange (EWS) și cauzând metoda addItemAttachmentAsync. Puteți obține identificator EWS pentru un element, calendar, contacte sau activitate în cutia poștală a utilizatorului, cauzând metoda mailbox.makeEwsRequestAsync de operare și folosind EWS FindItem. item.itemId proprietate oferă, de asemenea identificator al unui element SEAR existent sub formă de citire.

Notă. În Outlook Web App, sau OWA pentru a crea dispozitive add-on poate fi folosit pentru a atașa o instanță a unei întâlniri repetate. Cu toate acestea, în Outlook clienții bogați încearcă să atașeze o copie a fișierului atașat va conduce la o serie de repetiții (ședința principală).

Ștergerea atașamente

Puteți elimina un atașament dintr-un element al mesajului sau reuniunea sub formă de creare, specificând anexele Identifier corespunzătoare și cauzând metoda removeAttachmentAsync. Este necesar să se elimine doar atașamentele care au fost adăugate la aceeași suprastructură în aceeași sesiune. Ai nevoie pentru a se asigura că identificatorul corespunde Investirea reale de investiții, în caz contrar metoda returnează o eroare. Ca tehnici și addFileAttachmentAsync addItemAttachmentAsync. removeAttachmentAsync este metoda asincron. Trebuie să specificați o metodă de apel invers pentru a verifica starea și erorile, folosind AsyncResult obiect parametru de ieșire. parametri suplimentari pot fi de asemenea transmise la metoda callback folosind parametrul asyncContext opțional. care este obiectul JSON, format din perechi de „cheie-valoare.“

Sfaturi pentru adăugarea și ștergerea atașamente

În cazul în care dvs. de a adăuga crearea adăuga sau elimina atașamente, formează un cod pentru a transmite un atașamentele act de identitate valabil atunci când apelați Eliminare-atașament și se ocupe de scenariul în care AsyncResult.error returnează InvalidAttachmentId. În funcție de locația și dimensiunea investiției pentru a finaliza operațiunea de atașare poate dura ceva timp. Următorul exemplu va păstra metodele de apel addFileAttachmentAsync. scrie și removeAttachmentAsync. Putem presupune că acestea sunt efectuate succesiv.

Deoarece metoda addFileAttachmentAsync este asincron, că, în ciuda faptului că addFileAttachmentAsync efectuate înainte de removeAttachmentAsync. removeAttachmentAsync apeluri și scrie pot fi efectuate pentru finalizarea addFileAttachmentAsync. Când se întâmplă acest lucru, rămâne nedefinit atașament. și apare o eroare pentru un apel removeAttachmentAsync, după cum se arată mai jos:

O modalitate de a preveni acest lucru - asigurați-vă că înainte de a apela setat atașament removeAttachmentAsync. O altă metodă - o metodă de a provoca removeAttachmentAsync apel invers addFileAttachmentAsync. ca în exemplul următor:

Următorul este un exemplu de date de ieșire: