Extensii Web

Extensii web

Acest ghid arată cum să citești și să modifici metadatele panoului de sarcini al unui Office Add-in încorporate într-un fișier .docx cu Aspose.Words FOSS pentru .NET. Aspose.Words FOSS pentru .NET poate citi și modifica panourile de sarcini ale extensiei web (Office Add-in) încorporate într-un fișier .docx — metadatele care asociază un document cu un Office Add-in și îl leagă de datele documentului — prin Document.WebExtensionTaskPanes și modelul de obiecte TaskPane/WebExtension.

Panouri de sarcini

Document.WebExtensionTaskPanes returnează un TaskPaneCollection de obiecte TaskPane. Fiecare TaskPane descrie unde și cum este amplasat panoul unui add-in: DockState (un TaskPaneDockState de Right sau Left), Row, Width, IsLocked, și IsVisible, plus o proprietate WebExtension care leagă la add-in în sine.

Identitatea și referințele extensiei web

WebExtension identifică add-in-ul prin Id și IsFrozen, și proprietatea sa Reference (un WebExtensionReference) expune Id, Version, Store și StoreType (un WebExtensionStoreType cum ar fi SPCatalog, Exchange sau FileSystem) care descriu de unde este distribuit add-in-ul. AlternateReferences conține un WebExtensionReferenceCollection de referințe de rezervă.

Legături și proprietăți personalizate

WebExtension.Bindings este un WebExtensionBindingCollection de WebExtensionBinding obiecte, fiecare construit ca new WebExtensionBinding(id, bindingType, appRef) și leagă o parte din datele documentului de add-in printr-un WebExtensionBindingType (Matrix, Table sau Text). WebExtension.Properties este un WebExtensionPropertyCollection de perechi simple de nume/valoare WebExtensionProperty, construit ca new WebExtensionProperty(name, value), utilizat pentru setări personalizate specifice add-in-ului care nu justifică o legătură completă.

Apartenență la colecție

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection și WebExtensionReferenceCollection împărtășesc toate același comportament de bază al colecției: Add(item), Clear(), Remove(index), GetEnumerator() și Count.

Sfaturi și cele mai bune practici

Verificați TaskPane.IsVisible înainte de a presupune că panoul unui add-in este afișat utilizatorului — un panou de sarcini poate fi înregistrat, dar ascuns.
WebExtensionReference.StoreType vă spune de unde provine un add-in (catalog, Exchange, sistem de fișiere, registru); folosiți-l pentru a distinge add-in-urile de primă parte de cele încărcate manual.
Legăturile leagă un anumit WebExtensionBindingType (matrice, tabel sau text simplu) de datele documentului — verificați tipul legăturii înainte de a presupune ce tip de date așteaptă un add-in.
Folosiți WebExtension.Properties pentru valori simple de configurare add-in de tip nume/valoare, în loc să încercați să le stocați în altă parte în document.

Probleme comune

Problemă	Cauză	Remediere
`Document.WebExtensionTaskPanes` este gol	Documentul nu are niciun Office Add-in înregistrat	Confirmați că sursa `.docx` într-adevăr încorporează un panou de activități înainte de a presupune că API este defect
Nu se poate determina din ce magazin provine un add-in	`StoreType` nu este verificat	Citește `WebExtensionReference.StoreType` alături de `Store` pentru a avea o imagine completă
Datele de legare nu corespund așteptărilor	Neconcordanță a tipului de legare	Verifică `WebExtensionBinding.BindingType` (`Matrix`, `Table`, `Text`) înainte de a consuma datele legate

FAQ

Cum pot găsi toate suplimentele Office înregistrate într-un document?

Enumerați Document.WebExtensionTaskPanes (un TaskPaneCollection); fiecare TaskPane.WebExtension vă oferă identitatea și configurația suplimentului.

Pot adăuga o nouă legătură sau proprietate de extensie web cu acest API?

Da — colecțiile (WebExtensionBindingCollection, WebExtensionPropertyCollection, etc.) suportă Add(), astfel încât puteți construi și adăuga noi obiecte WebExtensionBinding/WebExtensionProperty la un WebExtension existent.

Ce leagă de fapt WebExtensionBinding?

Leagă o parte din datele documentului de supliment, utilizând un WebExtensionBindingType (Matrix, Table sau Text) pentru a descrie structura acelor date.

Cum pot citi setările personalizate ale suplimentului stocate în document?

Iterați WebExtension.Properties (un WebExtensionPropertyCollection); fiecare WebExtensionProperty expune o pereche Name/Value.

API Reference Rezumat

Clasă / Metodă	Descriere:
`Document.WebExtensionTaskPanes`	`TaskPaneCollection` de panouri de sarcini înregistrate în document
`TaskPane`	Un panou de add-in: `DockState`, `Row`, `Width`, `IsVisible`, `IsLocked`, `WebExtension`
`WebExtension`	Identitatea add-in-ului: `Id`, `IsFrozen`, `Reference`, `Bindings`, `Properties`
`WebExtensionReference`	Sursa add-in-ului: `Id`, `Version`, `Store`, `StoreType`
`WebExtensionBinding`	Leagă datele documentului de add-in prin `WebExtensionBindingType`
`WebExtensionProperty`	Setare personalizată a add-in-ului ca o pereche `Name`/`Value`

Vezi și:

Aspose.Words for .NET — Enterprise Documentation