Estensioni Web

Estensioni Web

Questa guida mostra come leggere e modificare i metadati del riquadro attività di Office Add-in incorporati in un file .docx con Aspose.Words FOSS per .NET. Aspose.Words FOSS per .NET può leggere e modificare i riquadri attività dell’estensione web (Office Add-in) incorporati in un file .docx — i metadati che associano un documento a un Office Add-in e lo collegano ai dati del documento — tramite Document.WebExtensionTaskPanes e il modello oggetto TaskPane/WebExtension.

Riquadri Attività

Document.WebExtensionTaskPanes restituisce un TaskPaneCollection di oggetti TaskPane. Ogni TaskPane descrive dove e come il riquadro di un add-in è ancorato: DockState (un TaskPaneDockState di Right o Left), Row, Width, IsLocked e IsVisible, più una proprietà WebExtension che collega all’add-in stesso.

Identità e Riferimenti dell’Estensione Web

WebExtension identifica l’add-in tramite Id e IsFrozen, e la sua proprietà Reference (un WebExtensionReference) espone Id, Version, Store e StoreType (un WebExtensionStoreType come SPCatalog, Exchange o FileSystem) che descrivono da dove l’add-in è distribuito. AlternateReferences contiene un WebExtensionReferenceCollection di riferimenti di fallback.

Collegamenti e Proprietà Personalizzate

WebExtension.Bindings è un WebExtensionBindingCollection di oggetti WebExtensionBinding, ciascuno costruito come new WebExtensionBinding(id, bindingType, appRef) e che collega parte dei dati del documento al componente aggiuntivo tramite un WebExtensionBindingType (Matrix, Table o Text). WebExtension.Properties è un WebExtensionPropertyCollection di coppie nome/valore WebExtensionProperty semplici, costruito come new WebExtensionProperty(name, value), usato per impostazioni personalizzate specifiche del componente aggiuntivo che non giustificano un binding completo.

Appartenenza alla collezione

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection e WebExtensionReferenceCollection condividono tutti lo stesso comportamento di base della collezione: Add(item), Clear(), Remove(index), GetEnumerator() e Count.

Suggerimenti e buone pratiche

• Verifica TaskPane.IsVisible prima di presumere che il riquadro di un componente aggiuntivo sia attualmente visibile all’utente — un riquadro di attività può essere registrato ma nascosto.
• WebExtensionReference.StoreType indica da dove proviene un componente aggiuntivo (catalogo, Exchange, file system, registro); usalo per distinguere i componenti aggiuntivi di prima parte da quelli caricati lateralmente.
• I binding collegano uno specifico WebExtensionBindingType (matrice, tabella o testo semplice) ai dati del documento — verifica il tipo di binding prima di presumere quale forma di dati si aspetti un componente aggiuntivo.
• Usa WebExtension.Properties per valori di configurazione nome/valore semplici del componente aggiuntivo invece di tentare di memorizzarli altrove nel documento.

Problemi comuni

FAQ

Come trovo tutti gli add-in di Office registrati in un documento?

Elenca Document.WebExtensionTaskPanes (un TaskPaneCollection); ogni TaskPane.WebExtension ti fornisce l’identità e la configurazione dell’add-in.

Posso aggiungere un nuovo binding o proprietà di estensione web con questo API?

Sì — le collezioni (WebExtensionBindingCollection, WebExtensionPropertyCollection, ecc.) supportano Add(), quindi puoi costruire e aggiungere nuovi oggetti WebExtensionBinding/WebExtensionProperty a un WebExtension esistente.

Cosa lega effettivamente WebExtensionBinding?

Collega una parte dei dati del documento all’add-in, usando un WebExtensionBindingType (Matrix, Table o Text) per descrivere la forma di quei dati.

Come leggo le impostazioni personalizzate del componente aggiuntivo memorizzate nel documento?

Itera WebExtension.Properties (un WebExtensionPropertyCollection); ogni WebExtensionProperty espone una coppia Name/Value.

API Reference Sommario

Vedi anche

• Aspose.Words for .NET — Enterprise Documentation