Legarea la câmpurile într-un document sau o foaie de calcul

Cea mai recentă versiune de referință pentru Office add-in-uri disponibile în depozitul de pe GitHub programe de completare.

Acest articol descrie modul de a crea legături de la domeniile de documente și foi de calcul pentru a efectua operațiuni de citire și scriere cu aceste legături. Mai mult decât atât, este descrisă crearea și ștergerea de manipulare eveniment de urmărire a modificărilor informațiilor sau o selecție de utilizare a elementelor în legarea.

Domeniul de aplicare: aplicații pentru birou | Excel | De completare Microsoft Office | cuvânt

Accesul la datele pe baza de legare prevede conținutul add-in-uri și acces consistente add-in panoul de activitate într-o anumită zonă a documentului sau a foii de calcul utilizând identificatorul corespunzător. Trebuie să instalați mai întâi add-ancora, provocând una dintre metodele de suprafață a documentului de legătură cu un identificator unic: addFromPromptAsync. addFromSelectionAsync sau addFromNamedItemAsync. După stabilirea legării suprastructurii se poate utiliza identificatorul prevăzut pentru accesul la datele conținute în zona corespunzătoare a documentului sau a foii de calcul. Crearea legări furnizează Adăugați valoarea următoarea:

Permite accesul la structuri de date partajate în aplicațiile Office suportate, cum ar fi: tabele, intervale sau text (secvență de caractere asociate).

Acesta oferă operații de citire-scriere, fără a fi necesar ca utilizatorul să facă alegerea potrivită.

Stabilește o legătură între suprastructura și datele din document. Bindings sunt stocate în document, accesul la acestea pot fi efectuate într-un moment ulterior.

Găsirea acest lucru, de asemenea, vă permite să vă abonați la date și selectați evenimente de modificare referitoare la o anumită zonă a documentului sau a foii de calcul. Acest lucru înseamnă că add-in este notificat doar schimbările care au loc în acest domeniu special, spre deosebire de modificările care afectează întregul document întreg sau foaia de calcul.

Object Bindings prevede metoda getAllAsync. care oferă acces la un set de legături specificate în acest document sau foaie de lucru. Accesul la o legare separat este disponibil pe identificatorul său prin metode Bindings.getBindingByIdAsync sau Office.select. Puteți crea un nou caracter obligatoriu, și elimina pe cele existente, utilizând una dintre metodele de mai jos obiect Bindings. addFromSelectionAsync. addFromPromptAsync. addFromNamedItemAsync sau releaseByIdAsync.

Există trei tipuri diferite de legături, care sunt determinate de parametrul bindingType atunci când se creează legături, prin metode addFromSelectionAsync. addFromPromptAsync sau addFromNamedItemAsync:

Funcția anonimă care este trecut la funcția ca parametru de apel invers. Se efectuează, după terminarea operației. Funcția este apelată cu un parametru de transfer asyncResult. care conține șirul de legături în document. Matricea se mută pentru a crea un șir de caractere care conține identificatorii de legare. Șirul este afișat în caseta de mesaj.

prin identificatorul de legare folosind metoda Bindings obiect Prepararea getByIdAsync

Următorul exemplu arată cum se utilizează metoda Bindings.getByIdAsync pentru legarea unui document prin specificarea identificatorul corespunzător. In acest exemplu, se presupune că legarea cu „Mybinding“ nume a fost adăugat la document prin una dintre metodele descrise anterior în această secțiune.

În acest exemplu, primul parametru id este identificatorul primit de legare.

Funcția anonimă care este trecut la funcția ca al doilea parametru de apel invers. Se efectuează, după terminarea operației. Funcția este apelată cu un parametru de transfer asyncResult. care cuprinde o stare de apel și legarea identificatorul „Mybinding“.

prin legarea identificator obținut prin metoda de selectare Oficiul obiect

Următorul exemplu arată cum se utilizează metoda de a obține Office.select obiect de legare într-un document prin specificarea ID-ul său la linia de selecție. Metoda Binding.getDataAsync este apoi chemat pentru a prelua date de legare a spus. In acest exemplu, se presupune că legarea cu „Mybinding“ nume a fost adăugat la document prin una dintre metodele descrise anterior în această secțiune.

Dacă metoda selectați obiectul promisiune returnează cu succes obiect Legare. Acest obiect expune numai următoarele patru metode obiect de legare. getDataAsync. setDataAsync. addHandlerAsync și removeHandlerAsync. Dacă nu vă promit să se întoarcă obiectul Legare. apel invers onerror poate fi folosit pentru a accesa asyncResult.error obiectului pentru informații suplimentare.

Dacă doriți să apelați obiect componentă de legare. altele decât cele patru metode oferite de Legare promisiunea obiect obiect (selectați metoda retururi), utilizați-l în locul metodei de utilizare a proprietății getByIdAsync Document.bindings și metoda Bindings.getByIdAsync pentru a obține obiect de legare.

Ștergerea legăturilor identificator

Următorul exemplu arată cum se utilizează metoda pentru a elimina Bindings.releaseByIdAsync lega documentul specificând identificatorul corespunzător.

În acest exemplu, primul parametru id-ul este identificatorul ancora șters.

Funcția anonimă care este trecut la funcția ca al doilea parametru este o funcție de apel invers, care se efectuează, după terminarea operației. Funcția este apelată cu un parametru de transfer asyncResult. care cuprinde o stare de apel.

Citirea datelor de la legarea

Următorul exemplu arată cum se utilizează metoda Binding.getDataAsync pentru obținerea de date de la un caracter obligatoriu existent.

Mybinding - variabilă ce conține textul obligatoriu existent în document. În plus, puteți utiliza metoda Office.select. pentru a avea acces la legarea identificatorul său și cauza metodei getDataAsync. Exemplu :. Office.select ( "legături # myBindingID") getDataAsync.

Funcția anonimă a trecut la funcția este un apel invers, care este executată la finalizarea operațiunii. proprietate AsyncResult.value conține Mybinding de date. tip de valoare depinde de tipul de legare. În acest exemplu, legarea textului, astfel încât valoarea ar trebui să conțină șirul. Pentru mai multe exemple folosind legări matrice și tabele văd. Într-un articol pe metoda Binding.getDataAsync.

Scrierea de date într-un bind

Următorul exemplu arată cum se utilizează metoda Binding.setDataAsync pentru definirea datelor într-o legare existentă.

Mybinding - variabilă ce conține textul obligatoriu existent în document.

În acest exemplu, primul parametru este o valoare pentru determinarea în Mybinding. Deoarece acesta este un text cu caracter obligatoriu, valoarea este un șir de caractere. Diferite tipuri de legături, care primesc diferite tipuri de date.

Funcția anonimă care este trecut la funcția este o funcție inversă, care se efectuează, după terminarea operației. Funcția este apelată cu un parametru de transfer asyncResult. care conține starea rezultatului.

Detectarea modificărilor în datele sau selectați o legătură

Următorul exemplu arată cum să atașați o tratare a evenimentului la identificator ancora DataChanged „Mybinding“.

Mybinding - variabilă ce conține textul obligatoriu existent în document.

Primul parametru Metoda eventType binding.addHandlerAsync specifică numele evenimentului pentru a va abona. Office.EventType - o enumerare a valorilor disponibile tipuri de legare. Office.EventType.BindingDataChanged comparativ cu șirul „bindingDataChanged“.

DataChanged de funcții. care este trecut la această funcție ca al doilea parametru handler. a doua tratare a evenimentelor care se execută atunci când datele în legarea. Funcția este apelată cu EventArgs un parametru. care conține o referire la legarea. Această legare poate fi utilizată pentru a obține date actualizate.

În mod similar, se poate determina momentul în care utilizatorul poate modifica alocarea legată prin adăugarea la evenimentul de tratare a evenimentului SelectionChanged obligatoriu. Pentru a face acest lucru, specificați parametrul metoda eventType binding.addHandlerAsync cum Office.EventType.BindingSelectionChanged sau „bindingSelectionChanged“.

Puteți adăuga mai multe manipulare eveniment pentru acest eveniment, provocând din nou metoda addHandlerAsync și care trece o funcție suplimentară de tratare a evenimentului pentru parametrul handler. Acest lucru va funcționa corect, deoarece numele fiecărei funcții handler eveniment este unic.

Eliminarea Eveniment Handlers

Pentru a elimina o tratare a evenimentului, apelați metoda Binding.removeHandlerAsync. trecerea tip de eveniment ca primul eventType parametru. precum și numele funcției de tratare a evenimentului șters ca al doilea parametru handler. De exemplu, următoarea funcție va șterge funcția dataChanged tratare a evenimentului. adăugat în exemplul din secțiunea anterioară.