Tiện ích mở rộng Web

Tiện ích Web

Hướng dẫn này cho thấy cách đọc và sửa đổi siêu dữ liệu bảng điều khiển tác vụ Office Add-in được nhúng trong tệp .docx bằng Aspose.Words FOSS cho .NET. Aspose.Words FOSS cho .NET có thể đọc và sửa đổi các bảng điều khiển tiện ích web (Office Add-in) được nhúng trong tệp .docx — siêu dữ liệu liên kết tài liệu với một Office Add-in và ràng buộc nó với dữ liệu tài liệu — thông qua Document.WebExtensionTaskPanes và mô hình đối tượng TaskPane/WebExtension.

Bảng điều khiển

Document.WebExtensionTaskPanes trả về một TaskPaneCollection các đối tượng TaskPane. Mỗi TaskPane mô tả vị trí và cách mà bảng điều khiển của add-in được gắn: DockState (một TaskPaneDockState của Right hoặc Left), Row, Width, IsLocked, và IsVisible, cộng với một thuộc tính WebExtension liên kết tới chính add-in.

Danh tính và Tham chiếu của Tiện ích Web

WebExtension xác định add-in thông qua Id và IsFrozen, và thuộc tính Reference của nó (một WebExtensionReference) công khai Id, Version, Store, và StoreType (một WebExtensionStoreType như SPCatalog, Exchange, hoặc FileSystem) mô tả nơi mà add-in được phân phối. AlternateReferences chứa một WebExtensionReferenceCollection các tham chiếu dự phòng.

Ràng buộc và Thuộc tính Tùy chỉnh

WebExtension.Bindings là một WebExtensionBindingCollection của các đối tượng WebExtensionBinding, mỗi đối tượng được tạo dưới dạng new WebExtensionBinding(id, bindingType, appRef) và liên kết một phần dữ liệu của tài liệu với add-in thông qua một WebExtensionBindingType (Matrix, Table, hoặc Text). WebExtension.Properties là một WebExtensionPropertyCollection của các cặp tên/giá trị WebExtensionProperty đơn giản, được tạo dưới dạng new WebExtensionProperty(name, value), dùng cho các cài đặt tùy chỉnh riêng của add-in mà không cần một binding đầy đủ.

Thành viên Bộ sưu tập

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection và WebExtensionReferenceCollection đều chia sẻ cùng một hành vi cơ bản của bộ sưu tập: Add(item), Clear(), Remove(index), GetEnumerator() và Count.

Mẹo và Thực hành Tốt nhất

Kiểm tra TaskPane.IsVisible trước khi giả định rằng bảng điều khiển của add-in đang được hiển thị cho người dùng — một task pane có thể đã được đăng ký nhưng lại ẩn.
WebExtensionReference.StoreType cho bạn biết add-in được lấy từ đâu (catalog, Exchange, hệ thống tệp, registry); sử dụng nó để phân biệt add-in của nhà cung cấp chính với các add-in được tải phụ.
Bindings liên kết một WebExtensionBindingType cụ thể (ma trận, bảng, hoặc văn bản thuần) với dữ liệu tài liệu — kiểm tra loại binding trước khi giả định dạng dữ liệu mà add-in mong đợi.
Sử dụng WebExtension.Properties cho các giá trị cấu hình add-in dạng tên/giá trị đơn giản thay vì cố gắng lưu chúng ở nơi khác trong tài liệu.

Vấn đề thường gặp

Vấn đề	Nguyên nhân	Cách khắc phục
`Document.WebExtensionTaskPanes` trống	Tài liệu không có Office Add-ins nào được đăng ký	Xác nhận nguồn `.docx` thực sự nhúng một task pane trước khi cho rằng API bị hỏng
Không thể xác định add-in đến từ cửa hàng nào	`StoreType` chưa được kiểm tra	Đọc `WebExtensionReference.StoreType` cùng với `Store` để có được bức tranh đầy đủ
Dữ liệu ràng buộc không khớp với mong đợi	Kiểu ràng buộc không khớp	Kiểm tra `WebExtensionBinding.BindingType` (`Matrix`, `Table`, `Text`) trước khi tiêu thụ dữ liệu đã ràng buộc

FAQ

Làm thế nào để tôi tìm tất cả các Office Add-ins đã đăng ký trong một tài liệu?

Liệt kê Document.WebExtensionTaskPanes (một TaskPaneCollection); mỗi TaskPane.WebExtension cung cấp cho bạn danh tính và cấu hình của add-in.

Tôi có thể thêm một ràng buộc hoặc thuộc tính mở rộng web mới bằng API này không?

Có — các bộ sưu tập (WebExtensionBindingCollection, WebExtensionPropertyCollection, v.v.) hỗ trợ Add(), vì vậy bạn có thể xây dựng và thêm các đối tượng WebExtensionBinding/WebExtensionProperty mới vào một WebExtension hiện có.

Thực tế WebExtensionBinding ràng buộc gì?

Nó liên kết một phần dữ liệu của tài liệu với add-in, sử dụng một WebExtensionBindingType (Matrix, Table hoặc Text) để mô tả cấu trúc của dữ liệu đó.

Làm thế nào để tôi đọc các cài đặt add-in tùy chỉnh được lưu trong tài liệu?

Lặp lại WebExtension.Properties (một WebExtensionPropertyCollection); mỗi WebExtensionProperty cung cấp một cặp Name/Value.

API Reference Tóm tắt

Lớp / Phương thức	Mô tả
`Document.WebExtensionTaskPanes`	`TaskPaneCollection` của các bảng điều khiển tác vụ đã đăng ký trong tài liệu
`TaskPane`	Một khung bổ trợ: `DockState`, `Row`, `Width`, `IsVisible`, `IsLocked`, `WebExtension`
`WebExtension`	Danh tính bổ trợ: `Id`, `IsFrozen`, `Reference`, `Bindings`, `Properties`
`WebExtensionReference`	Nguồn bổ trợ: `Id`, `Version`, `Store`, `StoreType`
`WebExtensionBinding`	Liên kết dữ liệu tài liệu với bổ trợ qua `WebExtensionBindingType`
`WebExtensionProperty`	Cài đặt add-in tùy chỉnh dưới dạng cặp `Name`/`Value`

Xem thêm

Aspose.Words for .NET — Enterprise Documentation