Rozszerzenia internetowe

Ten przewodnik pokazuje, jak odczytywać i modyfikować metadane panelu zadań dodatku Office osadzone w pliku .docx przy użyciu Aspose.Words FOSS dla .NET. Aspose.Words FOSS dla .NET może odczytywać i modyfikować panele zadań rozszerzenia internetowego (dodatku Office) osadzone w pliku .docx — metadane, które kojarzą dokument z dodatkiem Office i wiążą go z danymi dokumentu — poprzez Document.WebExtensionTaskPanes oraz model obiektowy TaskPane/WebExtension.

Panele zadań

Document.WebExtensionTaskPanes zwraca TaskPaneCollection obiektów TaskPane. Każdy TaskPane opisuje, gdzie i jak panel dodatku jest dokowany: DockState ( TaskPaneDockState Right lub Left), Row, Width, IsLocked i IsVisible, plus własność WebExtension łącząca z samym dodatkiem.

Tożsamość i odwołania rozszerzenia internetowego

WebExtension identyfikuje dodatek za pomocą Id i IsFrozen, a jego własność Reference ( WebExtensionReference) udostępnia Id, Version, Store oraz StoreType ( WebExtensionStoreType taki jak SPCatalog, Exchange lub FileSystem) opisujące, skąd dodatek jest dystrybuowany. AlternateReferences zawiera WebExtensionReferenceCollection odwołań zapasowych.

Powiązania i własności niestandardowe

WebExtension.Bindings jest WebExtensionBindingCollection WebExtensionBinding obiektów, każdy tworzony jako new WebExtensionBinding(id, bindingType, appRef) i łączący część danych dokumentu z dodatkiem za pomocą WebExtensionBindingType (Matrix, Table lub Text). WebExtension.Properties jest WebExtensionPropertyCollection prostych par nazw/wartości WebExtensionProperty, skonstruowanych jako new WebExtensionProperty(name, value), używanych do specyficznych dla dodatku niestandardowych ustawień, które nie wymagają pełnego powiązania.

Członkostwo kolekcji

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection i WebExtensionReferenceCollection wszystkie dzielą to samo podstawowe zachowanie kolekcji: Add(item), Clear(), Remove(index), GetEnumerator() i Count.

Wskazówki i najlepsze praktyki

Sprawdź TaskPane.IsVisible przed założeniem, że panel dodatku jest aktualnie wyświetlany użytkownikowi — panel zadania może być zarejestrowany, ale ukryty.
WebExtensionReference.StoreType informuje, skąd pochodzi dodatek (katalog, Exchange, system plików, rejestr); użyj go, aby odróżnić dodatki pierwszej strony od dodatków wczytywanych ręcznie.
Powiązania łączą określony WebExtensionBindingType (macierz, tabela lub zwykły tekst) z danymi dokumentu — sprawdź typ powiązania przed założeniem, jaką formę danych oczekuje dodatek.
Użyj WebExtension.Properties do prostych wartości konfiguracyjnych dodatku w formie nazwa/wartość, zamiast próbować przechowywać je w innym miejscu dokumentu.

Typowe problemy

Problem	Przyczyna	Naprawa
`Document.WebExtensionTaskPanes` jest pusty	Dokument nie ma zarejestrowanych dodatków Office	Potwierdź, że źródło `.docx` faktycznie osadza panel zadań, zanim założysz, że API jest uszkodzony
Nie można określić, z którego sklepu pochodzi dodatek	`StoreType` nie sprawdzono	Przeczytaj `WebExtensionReference.StoreType` wraz z `Store`, aby uzyskać pełny obraz
Dane powiązania nie odpowiadają oczekiwaniom	Niezgodność typu powiązania	Sprawdź `WebExtensionBinding.BindingType` (`Matrix`, `Table`, `Text`) przed użyciem powiązanych danych

FAQ

Jak znaleźć wszystkie dodatki Office zarejestrowane w dokumencie?

Wylicz Document.WebExtensionTaskPanes (a TaskPaneCollection); każdy TaskPane.WebExtension dostarcza tożsamość dodatku i jego konfigurację.

Czy mogę dodać nowe powiązanie rozszerzenia internetowego lub właściwość przy użyciu tego API?

Tak — kolekcje (WebExtensionBindingCollection, WebExtensionPropertyCollection, itp.) obsługują Add(), więc możesz tworzyć i dodawać nowe obiekty WebExtensionBinding/WebExtensionProperty do istniejącego WebExtension.

Co tak naprawdę wiąże WebExtensionBinding?

Łączy część danych dokumentu z dodatkiem, używając WebExtensionBindingType (Matrix, Table lub Text) do opisania struktury tych danych.

Jak odczytać niestandardowe ustawienia dodatku przechowywane w dokumencie?

Iteruj WebExtension.Properties (a WebExtensionPropertyCollection); każdy WebExtensionProperty udostępnia parę Name/Value.

API Reference Podsumowanie

Klasa / Metoda	Opis
`Document.WebExtensionTaskPanes`	`TaskPaneCollection` paneli zadań zarejestrowanych w dokumencie
`TaskPane`	Jeden panel dodatku: `DockState`, `Row`, `Width`, `IsVisible`, `IsLocked`, `WebExtension`
`WebExtension`	Tożsamość dodatku: `Id`, `IsFrozen`, `Reference`, `Bindings`, `Properties`
`WebExtensionReference`	Źródło dodatku: `Id`, `Version`, `Store`, `StoreType`
`WebExtensionBinding`	Łączy dane dokumentu z dodatkiem za pośrednictwem `WebExtensionBindingType`
`WebExtensionProperty`	Własne ustawienie dodatku jako para `Name`/`Value`

Zobacz także

Aspose.Words for .NET — Enterprise Documentation