Webbővítmények
Webkiterjesztések
Ez az útmutató bemutatja, hogyan lehet olvasni és módosítani az Office Add-in feladattábla metaadatait, amelyek egy .docx fájlban vannak beágyazva a Aspose.Words FOSS segítségével a .NET számára. A Aspose.Words FOSS a .NET számára képes olvasni és módosítani a webkiterjesztés (Office Add-in) feladattáblákat, amelyek egy .docx fájlban vannak beágyazva — a metaadatok, amelyek egy dokumentumot egy Office Add-inhez kapcsolnak, és azt a dokumentum adataihoz kötik — a Document.WebExtensionTaskPanes és a TaskPane/WebExtension objektummodellen keresztül.
Feladatpanelek
Document.WebExtensionTaskPanes egy TaskPaneCollection TaskPane objektumot ad vissza. Minden TaskPane leírja, hogy hol és hogyan van dokkolva a bővítmény panelje: DockState (egy TaskPaneDockState Right vagy Left), Row, Width, IsLocked, és IsVisible, valamint egy WebExtension tulajdonság, amely a bővítményre hivatkozik.
Webkiterjesztés azonosítója és hivatkozásai
WebExtension a Id és IsFrozen segítségével azonosítja a bővítményt, és annak Reference tulajdonsága (egy WebExtensionReference) felfedi a Id, Version, Store és StoreType (egy WebExtensionStoreType, például SPCatalog, Exchange vagy FileSystem) leírását, amelyek azt mutatják, honnan terjesztik a bővítményt. AlternateReferences egy WebExtensionReferenceCollection tartalmaz a tartalék hivatkozásokból.
Kötések és egyedi tulajdonságok
WebExtension.Bindings egy WebExtensionBindingCollection WebExtensionBinding objektumból, amelyek mindegyike new WebExtensionBinding(id, bindingType, appRef) módon van felépítve, és a dokumentum adatainak egy részét a kiegészítőhöz egy WebExtensionBindingType (Matrix, Table vagy Text) segítségével kapcsolja. WebExtension.Properties egy WebExtensionPropertyCollection egyszerű WebExtensionProperty név/érték párokból, new WebExtensionProperty(name, value) módon felépítve, amelyet a kiegészítőspecifikus egyéni beállításokhoz használnak, amelyek nem igényelnek teljes kötést.
Gyűjtemény tagság
TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection és WebExtensionReferenceCollection mind ugyanazt az alapgyűjtemény viselkedést osztják meg: Add(item), Clear(), Remove(index), GetEnumerator() és Count.
Tippek és bevált gyakorlatok
- Ellenőrizze a(z)
TaskPane.IsVisibleértékét, mielőtt azt feltételezné, hogy a kiegészítő ablaka jelenleg meg van jelenítve a felhasználónak — egy feladatablak regisztrálva lehet, de rejtett. WebExtensionReference.StoreTypemegmutatja, hogy a kiegészítő honnan származik (katalógus, Exchange, fájlrendszer, regisztráció); használja ezt a belső (first-party) és a betöltött (sideloaded) kiegészítők megkülönböztetésére.- A kötés egy adott
WebExtensionBindingType(mátrix, táblázat vagy egyszerű szöveg) és a dokumentum adatai között hoz létre kapcsolatot — ellenőrizze a kötés típusát, mielőtt azt feltételezné, milyen adatformátumot vár el a kiegészítő. - Használja a(z)
WebExtension.Propertiesegyszerű név/érték kiegészítő konfigurációs értékekhez, ahelyett, hogy megpróbálná őket máshol a dokumentumban tárolni.
Gyakori problémák
| Probléma | Ok | Javítás |
|---|---|---|
Document.WebExtensionTaskPanes üres | A dokumentumban nincs regisztrált Office kiegészítő | Erősítse meg, hogy a(z) .docx forrás valóban beágyaz egy feladatpanelt, mielőtt azt feltételezné, hogy a(z) API hibás. |
| Nem lehet megállapítani, melyik áruházból származik egy kiegészítő | StoreType nincs ellenőrizve | Olvasd el a(z) WebExtensionReference.StoreType a(z) Store mellett a teljes képhez |
| A kötési adatok nem felelnek meg a várakozásoknak | Kötéstípus eltérés | Ellenőrizd a(z) WebExtensionBinding.BindingType (Matrix, Table, Text) a kötött adatok felhasználása előtt |
FAQ
Hogyan találhatom meg az összes Office Add-ins-et, amely egy dokumentumban regisztrálva van?
Sorolja fel a Document.WebExtensionTaskPanes (a TaskPaneCollection); minden TaskPane.WebExtension megadja a kiegészítő azonosítóját és konfigurációját.
Hozzáadhatok új webkiterjesztés kötést vagy tulajdonságot ezzel a API?
Igen — a gyűjtemények (WebExtensionBindingCollection, WebExtensionPropertyCollection, stb.) támogatják a Add()-t, így új WebExtensionBinding/WebExtensionProperty objektumokat hozhat létre és adhat hozzá egy meglévő WebExtension-hez.
A WebExtensionBinding valójában mit köt?
Összekapcsolja a dokumentum adatainak egy részét a kiegészítővel, egy WebExtensionBindingType (Matrix, Table vagy Text) használatával, amely leírja az adat szerkezetét.
Hogyan olvashatom be a dokumentumban tárolt egyéni kiegészítő beállításokat?
Iterálja a WebExtension.Properties (egy WebExtensionPropertyCollection); minden WebExtensionProperty egy Name/Value párt tesz elérhetővé.
API Reference összefoglaló
| Osztály / Metódus | Leírás |
|---|---|
Document.WebExtensionTaskPanes | A dokumentumban regisztrált feladatpanelek TaskPaneCollection |
TaskPane | Egy kiegészítő panel: DockState, Row, Width, IsVisible, IsLocked, WebExtension |
WebExtension | Kiegészítő azonosító: Id, IsFrozen, Reference, Bindings, Properties |
WebExtensionReference | Kiegészítő forrás: Id, Version, Store, StoreType |
WebExtensionBinding | A dokumentum adatait a kiegészítőhöz kapcsolja a(z) WebExtensionBindingType segítségével |
WebExtensionProperty | Egyéni bővítmény beállításként Name/Value pároként |
