Webbläsartillägg

Webb-tillägg

Denna guide visar hur man läser och modifierar Office Add-in-uppgiftspanelförmetadata som är inbäddad i en .docx-fil med Aspose.Words FOSS för .NET. Aspose.Words FOSS för .NET kan läsa och modifiera webbläsartilläggets (Office Add-in) uppgiftspaneler som är inbäddade i en .docx-fil — metadata som associerar ett dokument med ett Office Add-in och binder det till dokumentdata — via Document.WebExtensionTaskPanes och TaskPane/WebExtension-objektmodellen.

Uppgiftspaneler

Document.WebExtensionTaskPanes returnerar en TaskPaneCollection av TaskPane objekt. Varje TaskPane beskriver var och hur ett tilläggs panel är dockad: DockState (en TaskPaneDockState av Right eller Left), Row, Width, IsLocked och IsVisible, plus en WebExtension egenskap som länkar till själva tillägget.

Webb-tilläggets identitet och referenser

WebExtension identifierar tillägget via Id och IsFrozen, och dess Reference egenskap (en WebExtensionReference) visar Id, Version, Store och StoreType (en WebExtensionStoreType såsom SPCatalog, Exchange eller FileSystem) som beskriver varifrån tillägget distribueras. AlternateReferences innehåller en WebExtensionReferenceCollection av reservreferenser.

Bindningar och anpassade egenskaper

WebExtension.Bindings är en WebExtensionBindingCollection av WebExtensionBinding objekt, var och en konstruerad som new WebExtensionBinding(id, bindingType, appRef) och länkar en del av dokumentets data till tillägget via en WebExtensionBindingType (Matrix, Table eller Text). WebExtension.Properties är en WebExtensionPropertyCollection av enkla WebExtensionProperty namn/värde-par, konstruerad som new WebExtensionProperty(name, value), som används för tilläggsspecifika anpassade inställningar som inte motiverar en fullständig bindning.

Samlingsmedlemskap

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection och WebExtensionReferenceCollection delar alla samma grundläggande samlingsbeteende: Add(item), Clear(), Remove(index), GetEnumerator() och Count.

Tips och bästa praxis

Kontrollera TaskPane.IsVisible innan du antar att ett tilläggs fönster för närvarande visas för användaren — ett uppgiftsfönster kan vara registrerat men dolt.
WebExtensionReference.StoreType berättar var ett tillägg hämtades ifrån (katalog, Exchange, filsystem, register); använd det för att särskilja förstapartstillägg från sidladdade tillägg.
Bindningar länkar en specifik WebExtensionBindingType (matris, tabell eller vanlig text) till dokumentdata — kontrollera bindningstypen innan du antar vilken datatyp ett tillägg förväntar sig.
Använd WebExtension.Properties för enkla namn/värde-konfigurationsvärden för tillägg snarare än att försöka lagra dem någon annanstans i dokumentet.

Vanliga problem

Problem	Orsak	Åtgärd
`Document.WebExtensionTaskPanes` är tom	Dokumentet har inga Office Add-ins registrerade	Bekräfta att källan `.docx` faktiskt bäddar in ett uppgiftspanel innan du antar att API är trasig
Kan inte avgöra vilken butik ett add-in kom från	`StoreType` ej kontrollerad	Läs `WebExtensionReference.StoreType` tillsammans med `Store` för att få hela bilden
Bindningsdata matchar inte förväntningarna	Typen för bindning stämmer inte	Kontrollera `WebExtensionBinding.BindingType` (`Matrix`, `Table`, `Text`) innan du använder bunden data

FAQ

Hur hittar jag alla Office Add-ins som är registrerade i ett dokument?

Enumerera Document.WebExtensionTaskPanes (en TaskPaneCollection); varje TaskPane.WebExtension ger dig tilläggets identitet och konfiguration.

Kan jag lägga till en ny web extension-bindning eller egenskap med detta API?

Ja — samlingarna (WebExtensionBindingCollection, WebExtensionPropertyCollection osv.) stöder Add(), så att du kan konstruera och lägga till nya WebExtensionBinding/WebExtensionProperty-objekt till en befintlig WebExtension.

Vad binder WebExtensionBinding egentligen?

Den länkar en del av dokumentets data till tillägget, med hjälp av en WebExtensionBindingType (Matrix, Table eller Text) för att beskriva formen på den datan.

Hur läser jag anpassade tilläggsinställningar som lagras i dokumentet?

Iterera WebExtension.Properties (en WebExtensionPropertyCollection); varje WebExtensionProperty exponerar ett Name/Value-par.

API Reference Sammanfattning

Klass / Metod	Beskrivning
`Document.WebExtensionTaskPanes`	`TaskPaneCollection` av uppgiftspaneler som är registrerade i dokumentet
`TaskPane`	Ett tilläggspanel: `DockState`, `Row`, `Width`, `IsVisible`, `IsLocked`, `WebExtension`
`WebExtension`	Tilläggsidentitet: `Id`, `IsFrozen`, `Reference`, `Bindings`, `Properties`
`WebExtensionReference`	Tilläggskälla: `Id`, `Version`, `Store`, `StoreType`
`WebExtensionBinding`	Länkar dokumentdata till tillägget via `WebExtensionBindingType`
`WebExtensionProperty`	Anpassad tilläggsinställning som ett `Name`/`Value`-par

Se även

Aspose.Words for .NET — Enterprise Documentation