Webextensies
Webextensies
Deze gids laat zien hoe je Office Add-in taakvenster-metadata die ingebed is in een .docx bestand kunt lezen en wijzigen met Aspose.Words FOSS voor .NET. Aspose.Words FOSS voor .NET kan de webextensie (Office Add-in) taakvensters die ingebed zijn in een .docx bestand — de metadata die een document koppelt aan een Office Add-in en bindt aan documentgegevens — lezen en wijzigen via Document.WebExtensionTaskPanes en het TaskPane/WebExtension objectmodel.
Taakvensters
Document.WebExtensionTaskPanes geeft een TaskPaneCollection van TaskPane objecten terug. Elk TaskPane beschrijft waar en hoe een add-in’s paneel is gedockt: DockState (een TaskPaneDockState van Right of Left), Row, Width, IsLocked, en IsVisible, plus een WebExtension eigenschap die linkt naar de add-in zelf.
Webextensie-identiteit en referenties
WebExtension identificeert de add-in via Id en IsFrozen, en zijn Reference eigenschap (een WebExtensionReference) legt Id, Version, Store en StoreType (een WebExtensionStoreType zoals SPCatalog, Exchange of FileSystem) bloot, die beschrijft waar de add-in wordt verspreid. AlternateReferences bevat een WebExtensionReferenceCollection van fallback-referenties.
Bindingen en aangepaste eigenschappen
WebExtension.Bindings is een WebExtensionBindingCollection van WebExtensionBinding objecten, elk geconstrueerd als new WebExtensionBinding(id, bindingType, appRef) en die een deel van de documentgegevens koppelt aan de add-in via een WebExtensionBindingType (Matrix, Table of Text). WebExtension.Properties is een WebExtensionPropertyCollection van eenvoudige WebExtensionProperty naam/waarde-paren, geconstrueerd als new WebExtensionProperty(name, value), gebruikt voor add-in-specifieke aangepaste instellingen die geen volledige binding rechtvaardigen.
Collectielidmaatschap
TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection en WebExtensionReferenceCollection delen allemaal hetzelfde basiscollectiegedrag: Add(item), Clear(), Remove(index), GetEnumerator() en Count.
Tips en beste werkwijzen
- Controleer
TaskPane.IsVisiblevoordat u ervan uitgaat dat het paneel van een add-in momenteel aan de gebruiker wordt getoond — een taakvenster kan geregistreerd maar verborgen zijn. WebExtensionReference.StoreTypevertelt u waar een add-in vandaan komt (catalogus, Exchange, bestandssysteem, register); gebruik het om first-party add-ins te onderscheiden van sideloaded add-ins.- Bindings koppelen een specifieke
WebExtensionBindingType(matrix, tabel of platte tekst) aan documentgegevens — controleer het bindingtype voordat u ervan uitgaat welke vorm van gegevens een add-in verwacht. - Gebruik
WebExtension.Propertiesvoor eenvoudige naam/waarde add-in-configuratiewaarden in plaats van te proberen ze elders in het document op te slaan.
Algemene problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
Document.WebExtensionTaskPanes is leeg | Het document heeft geen Office Add-ins geregistreerd | Bevestig dat de bron .docx daadwerkelijk een taakvenster bevat voordat u aanneemt dat de API defect is |
| Kan niet achterhalen uit welke winkel een add-in komt | StoreType niet gecontroleerd | Lees WebExtensionReference.StoreType naast Store voor het volledige beeld |
| Binding data komt niet overeen met de verwachtingen | Bindingtype mismatch | Controleer WebExtensionBinding.BindingType (Matrix, Table, Text) voordat u bound data consumeert |
FAQ
Hoe vind ik alle Office Add-ins die in een document zijn geregistreerd?
Som Document.WebExtensionTaskPanes op (een TaskPaneCollection); elke TaskPane.WebExtension geeft je de identiteit en configuratie van de add-in.
Kan ik een nieuwe webextensie-binding of -eigenschap toevoegen met deze API?
Ja — de collecties (WebExtensionBindingCollection, WebExtensionPropertyCollection, enz.) ondersteunen Add(), zodat je nieuwe WebExtensionBinding/WebExtensionProperty-objecten kunt samenstellen en toevoegen aan een bestaande WebExtension.
Wat bindt WebExtensionBinding eigenlijk?
Het koppelt een deel van de documentgegevens aan de add-in, met behulp van een WebExtensionBindingType (Matrix, Table of Text) om de structuur van die gegevens te beschrijven.
Hoe lees ik aangepaste add-in-instellingen die in het document zijn opgeslagen?
Itereer WebExtension.Properties (een WebExtensionPropertyCollection); elke WebExtensionProperty exposeert een Name/Value-paar.
API Reference Samenvatting
| Klasse / Methode | Beschrijving |
|---|---|
Document.WebExtensionTaskPanes | TaskPaneCollection van taakvensters die in het document zijn geregistreerd |
TaskPane | Een add-inpaneel: DockState, Row, Width, IsVisible, IsLocked, WebExtension |
WebExtension | Add-in-identiteit: Id, IsFrozen, Reference, Bindings, Properties |
WebExtensionReference | Add-in-bron: Id, Version, Store, StoreType |
WebExtensionBinding | Koppelt documentgegevens aan de add-in via WebExtensionBindingType |
WebExtensionProperty | Aangepaste add-in-instelling als een Name/Value paar |
