Επεκτάσεις Web

Επεκτάσεις Ιστού

Αυτός ο οδηγός δείχνει πώς να διαβάσετε και να τροποποιήσετε τα μεταδεδομένα του task pane του Office Add-in που είναι ενσωματωμένα σε ένα αρχείο .docx με το Aspose.Words FOSS για .NET. Το Aspose.Words FOSS για .NET μπορεί να διαβάσει και να τροποποιήσει τα task panes της επέκτασης ιστού (Office Add-in) που είναι ενσωματωμένα σε ένα αρχείο .docx — τα μεταδεδομένα που συνδέουν ένα έγγραφο με ένα Office Add-in και το δεσμεύουν στα δεδομένα του εγγράφου — μέσω του Document.WebExtensionTaskPanes και του αντικειμενοστραφούς μοντέλου TaskPane/WebExtension.

Πάνελ εργασίας

Document.WebExtensionTaskPanes επιστρέφει ένα TaskPaneCollection από αντικείμενα TaskPane. Κάθε TaskPane περιγράφει πού και πώς το πάνελ ενός πρόσθετου είναι προσαρτημένο: DockState (ένα TaskPaneDockState από Right ή Left), Row, Width, IsLocked, και IsVisible, συν ένα χαρακτηριστικό WebExtension που συνδέει με το ίδιο το πρόσθετο.

Ταυτότητα και Αναφορές Επέκτασης Ιστού

WebExtension προσδιορίζει το πρόσθετο μέσω Id και IsFrozen, και η ιδιότητα Reference του (ένα WebExtensionReference) εκθέτει Id, Version, Store και StoreType (ένα WebExtensionStoreType όπως SPCatalog, Exchange, ή FileSystem) που περιγράφει από πού διανέμεται το πρόσθετο. Το AlternateReferences περιέχει ένα WebExtensionReferenceCollection εναλλακτικών αναφορών.

Δεσμεύσεις και Προσαρμοσμένες Ιδιότητες

WebExtension.Bindings είναι ένα WebExtensionBindingCollection από WebExtensionBinding αντικείμενα, το καθένα κατασκευασμένο ως new WebExtensionBinding(id, bindingType, appRef) και συνδέει μέρος των δεδομένων του εγγράφου με το πρόσθετο μέσω ενός WebExtensionBindingType (Matrix, Table ή Text). WebExtension.Properties είναι ένα WebExtensionPropertyCollection απλών ζευγών WebExtensionProperty όνομα/τιμή, κατασκευασμένο ως new WebExtensionProperty(name, value), που χρησιμοποιείται για προσαρμοσμένες ρυθμίσεις του πρόσθετου που δεν απαιτούν πλήρη σύνδεση.

Συμμετοχή Συλλογής

Τα TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection και WebExtensionReferenceCollection μοιράζονται όλα τη ίδια βασική συμπεριφορά συλλογής: Add(item), Clear(), Remove(index), GetEnumerator() και Count.

Συμβουλές και Καλύτερες Πρακτικές

• Ελέγξτε το TaskPane.IsVisible πριν υποθέσετε ότι το πάνελ ενός πρόσθετου εμφανίζεται τρέχοντα στον χρήστη — ένα πάνελ εργασίας μπορεί να είναι καταχωρημένο αλλά κρυφό.
• Το WebExtensionReference.StoreType σας δείχνει από πού προήλθε ένα πρόσθετο (κατάλογος, Exchange, σύστημα αρχείων, μητρώο); χρησιμοποιήστε το για να διακρίνετε τα πρόσθετα πρώτου μέρους από τα sideloaded.
• Οι συνδέσεις συνδέουν ένα συγκεκριμένο WebExtensionBindingType (matrix, table, or plain text) με τα δεδομένα του εγγράφου — ελέγξτε τον τύπο σύνδεσης πριν υποθέσετε ποια μορφή δεδομένων αναμένει ένα πρόσθετο.
• Χρησιμοποιήστε το WebExtension.Properties για απλές τιμές ρυθμίσεων πρόσθετου όνομα/τιμή αντί να προσπαθήσετε να τις αποθηκεύσετε αλλού στο έγγραφο.

Συνηθισμένα προβλήματα

FAQ

Πώς μπορώ να βρω όλα τα Office Add-ins που είναι καταχωρημένα σε ένα έγγραφο;

Απαριθμίστε το Document.WebExtensionTaskPanes (ένα TaskPaneCollection); κάθε TaskPane.WebExtension σας παρέχει την ταυτότητα και τη διαμόρφωση του πρόσθετου.

Μπορώ να προσθέσω μια νέα σύνδεση ή ιδιότητα web extension με αυτό το API;

Ναι — οι συλλογές (WebExtensionBindingCollection, WebExtensionPropertyCollection, κλπ.) υποστηρίζουν το Add(), ώστε να μπορείτε να δημιουργήσετε και να προσθέσετε νέα αντικείμενα WebExtensionBinding/WebExtensionProperty σε μια υπάρχουσα WebExtension.

Τι συνδέει πραγματικά το WebExtensionBinding;

Συνδέει ένα τμήμα των δεδομένων του εγγράφου με το πρόσθετο, χρησιμοποιώντας ένα WebExtensionBindingType (Matrix, Table ή Text) για να περιγράψει τη μορφή αυτών των δεδομένων.

Πώς μπορώ να διαβάσω τις προσαρμοσμένες ρυθμίσεις add-in που είναι αποθηκευμένες στο έγγραφο;

Επανάληψη WebExtension.Properties (ένα WebExtensionPropertyCollection); κάθε WebExtensionProperty εκθέτει ένα ζεύγος Name/Value.

API Reference Περίληψη

Δείτε επίσης

• Aspose.Words for .NET — Enterprise Documentation