Extensions Web
Extensions Web
Ce guide montre comment lire et modifier les métadonnées du volet de tâche d’un Office Add-in intégrées dans un fichier .docx avec Aspose.Words FOSS pour .NET. Aspose.Words FOSS pour .NET peut lire et modifier les volets de tâche de l’extension Web (Office Add-in) intégrés dans un fichier .docx — les métadonnées qui associent un document à un Office Add-in et le lient aux données du document — via Document.WebExtensionTaskPanes et le modèle d’objet TaskPane/WebExtension.
Volets de tâche
Document.WebExtensionTaskPanes renvoie un TaskPaneCollection d’objets TaskPane. Chaque TaskPane décrit où et comment le volet d’un module est ancré: DockState (un TaskPaneDockState de Right ou Left), Row, Width, IsLocked et IsVisible, plus une propriété WebExtension liant au module lui-même.
Identité et références de l’extension Web
WebExtension identifie le module via Id et IsFrozen, et sa propriété Reference (un WebExtensionReference) expose Id, Version, Store et StoreType (un WebExtensionStoreType tel que SPCatalog, Exchange ou FileSystem) décrivant d’où le module est distribué. AlternateReferences contient un WebExtensionReferenceCollection de références de secours.
Liaisons et propriétés personnalisées
WebExtension.Bindings est un WebExtensionBindingCollection de objets WebExtensionBinding, chacun construit comme new WebExtensionBinding(id, bindingType, appRef) et reliant une partie des données du document à l’add-in via un WebExtensionBindingType (Matrix, Table ou Text). WebExtension.Properties est un WebExtensionPropertyCollection de simples WebExtensionProperty paires nom/valeur, construit comme new WebExtensionProperty(name, value), utilisé pour les paramètres personnalisés spécifiques à l’add-in qui ne justifient pas une liaison complète.
Appartenance à la collection
TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection et WebExtensionReferenceCollection partagent tous le même comportement de collection de base : Add(item), Clear(), Remove(index), GetEnumerator() et Count.
Conseils et bonnes pratiques
- Vérifiez
TaskPane.IsVisibleavant de supposer que le volet d’un add-in est actuellement affiché à l’utilisateur — un volet de tâche peut être enregistré mais masqué. WebExtensionReference.StoreTypeindique d’où provient un add-in (catalogue, Exchange, système de fichiers, registre) ; utilisez-le pour distinguer les add-ins de première partie des add-ins chargés manuellement.- Les liaisons relient un
WebExtensionBindingTypespécifique (matrice, tableau ou texte brut) aux données du document — vérifiez le type de liaison avant de supposer la forme des données attendues par un add-in. - Utilisez
WebExtension.Propertiespour des valeurs de configuration d’add-in simples nom/valeur plutôt que d’essayer de les stocker ailleurs dans le document.
Problèmes courants
| Problème | Cause | Correction |
|---|---|---|
Document.WebExtensionTaskPanes est vide | Le document n’a aucun Office Add-ins enregistré | Confirmez que la source .docx intègre réellement un volet de tâche avant de supposer que le API est défectueux |
| Impossible de dire de quel magasin provient l’add-in | StoreType non vérifié | Lire WebExtensionReference.StoreType en même temps que Store pour obtenir une vision complète |
| Les données liées ne correspondent pas aux attentes | Incompatibilité du type de liaison | Vérifiez WebExtensionBinding.BindingType (Matrix, Table, Text) avant de consommer les données liées |
FAQ
Comment trouver tous les compléments Office enregistrés dans un document?
Énumérez Document.WebExtensionTaskPanes (un TaskPaneCollection); chaque TaskPane.WebExtension vous fournit l’identité et la configuration du complément.
Puis-je ajouter une nouvelle liaison d’extension Web ou une propriété avec ce API?
Oui — les collections (WebExtensionBindingCollection, WebExtensionPropertyCollection, etc.) prennent en charge Add(), de sorte que vous pouvez créer et ajouter de nouveaux objets WebExtensionBinding/WebExtensionProperty à un WebExtension existant.
Que lie réellement WebExtensionBinding?
Il lie une partie des données du document au complément, en utilisant un WebExtensionBindingType (Matrix, Table ou Text) pour décrire la forme de ces données.
Comment lire les paramètres d’add-in personnalisés stockés dans le document ?
Itérer WebExtension.Properties (un WebExtensionPropertyCollection); chaque WebExtensionProperty expose une paire Name/Value .
API Reference Résumé
| Classe / Méthode | Description |
|---|---|
Document.WebExtensionTaskPanes | TaskPaneCollection des volets de tâche enregistrés dans le document |
TaskPane | Un volet de module complémentaire : DockState, Row, Width, IsVisible, IsLocked, WebExtension |
WebExtension | Identité du module complémentaire : Id, IsFrozen, Reference, Bindings, Properties |
WebExtensionReference | Source du module complémentaire : Id, Version, Store, StoreType |
WebExtensionBinding | Lie les données du document au module complémentaire via WebExtensionBindingType |
WebExtensionProperty | Paramètre d’add-in personnalisé sous forme d’une paire Name/Value |
