Webová rozšíření

Tento průvodce ukazuje, jak číst a upravovat metadata panelů úloh Office Add-in vložená do souboru .docx pomocí Aspose.Words FOSS pro .NET. Aspose.Words FOSS pro .NET může číst a upravovat webová rozšíření (Office Add-in) panely úloh vložené do souboru .docx— metadata, která spojují dokument s Office Add-in a vážou jej k datům dokumentu— prostřednictvím Document.WebExtensionTaskPanes a objektového modelu TaskPane/WebExtension.

Panely úloh

Document.WebExtensionTaskPanes vrací TaskPaneCollection TaskPane objektů. Každý TaskPane popisuje, kde a jak je panel doplňku ukotven: DockState (a TaskPaneDockState Right nebo Left), Row, Width, IsLocked a IsVisible, plus vlastnost WebExtension odkazující na samotný doplněk.

Identita a reference webového rozšíření

WebExtension identifikuje doplněk pomocí Id a IsFrozen, a jeho vlastnost Reference (a WebExtensionReference) zveřejňuje Id, Version, Store a StoreType (a WebExtensionStoreType jako SPCatalog, Exchange nebo FileSystem) popisující, odkud je doplněk distribuován. AlternateReferences obsahuje WebExtensionReferenceCollection náhradních referencí.

Vazby a vlastní vlastnosti

WebExtension.Bindings je WebExtensionBindingCollection WebExtensionBinding objektů, z nichž každý je vytvořen jako new WebExtensionBinding(id, bindingType, appRef) a propojuje část dat dokumentu s doplňkem prostřednictvím WebExtensionBindingType (Matrix, Table nebo Text). WebExtension.Properties je WebExtensionPropertyCollection jednoduchých WebExtensionProperty páru jméno/hodnota, vytvořených jako new WebExtensionProperty(name, value), používaných pro specifická nastavení doplňku, která nevyžadují úplné vazby.

Členství kolekce

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection a WebExtensionReferenceCollection sdílejí stejné základní chování kolekce: Add(item), Clear(), Remove(index), GetEnumerator() a Count.

Tipy a osvědčené postupy

Zkontrolujte TaskPane.IsVisible, než předpokládáte, že panel doplňku je uživateli aktuálně zobrazen — task pane může být registrován, ale skrytý.
WebExtensionReference.StoreType vám říká, odkud byl doplněk získán (katalog, Exchange, souborový systém, registr); použijte jej k rozlišení oficiálních doplňků od sideloadovaných.
Vazby propojují konkrétní WebExtensionBindingType (matici, tabulku nebo prostý text) s daty dokumentu — zkontrolujte typ vazby, než předpokládáte, jakou strukturu dat doplněk očekává.
Použijte WebExtension.Properties pro jednoduché konfigurační hodnoty doplňku typu jméno/hodnota místo toho, abyste se snažili je ukládat jinde v dokumentu.

Běžné problémy

Problém	Příčina	Oprava
`Document.WebExtensionTaskPanes` je prázdný	Dokument nemá registrované žádné doplňky Office	Potvrďte, že zdroj `.docx` skutečně obsahuje panel úkolů, než předpokládáte, že API je poškozený
Nelze zjistit, z jakého obchodu doplněk pochází	`StoreType` nebyl zkontrolován	Přečtěte `WebExtensionReference.StoreType` spolu s `Store` pro úplný obrázek
Vazebná data neodpovídají očekáváním	Neshoda typu vazby	Zkontrolujte `WebExtensionBinding.BindingType` (`Matrix`, `Table`, `Text`) před použitím svázaných dat

FAQ

Jak najdu všechny Office Add-ins registrované v dokumentu?

Vyjmenujte Document.WebExtensionTaskPanes (a TaskPaneCollection); každý TaskPane.WebExtension vám poskytne identitu a konfiguraci doplňku.

Mohu pomocí tohoto API přidat nové vazby webového rozšíření nebo vlastnost?

Ano — kolekce (WebExtensionBindingCollection, WebExtensionPropertyCollection atd.) podporují Add(), takže můžete vytvořit a přidat nové objekty WebExtensionBinding/WebExtensionProperty do existujícího WebExtension.

Co WebExtensionBinding ve skutečnosti váže?

Propojí část dat dokumentu s doplňkem pomocí WebExtensionBindingType (Matrix, Table nebo Text) k popisu struktury těchto dat.

Jak mohu načíst vlastní nastavení doplňku uložené v dokumentu?

Iterujte WebExtension.Properties (a WebExtensionPropertyCollection); každý WebExtensionProperty zveřejňuje dvojici Name/Value.

API Reference Shrnutí

Třída / Metoda	Popis:
`Document.WebExtensionTaskPanes`	`TaskPaneCollection` panelů úloh registrovaných v dokumentu
`TaskPane`	Jeden panel doplňku: `DockState`, `Row`, `Width`, `IsVisible`, `IsLocked`, `WebExtension`
`WebExtension`	Identita doplňku: `Id`, `IsFrozen`, `Reference`, `Bindings`, `Properties`
`WebExtensionReference`	Zdroj doplňku: `Id`, `Version`, `Store`, `StoreType`
`WebExtensionBinding`	Propojuje data dokumentu s doplňkem prostřednictvím `WebExtensionBindingType`
`WebExtensionProperty`	Vlastní nastavení doplňku jako pár `Name`/`Value`

Viz také:

Aspose.Words for .NET — Enterprise Documentation