Ekstensi Web

Panduan ini menunjukkan cara membaca dan memodifikasi metadata panel tugas Office Add-in yang tertanam dalam file .docx dengan Aspose.Words FOSS untuk .NET. Aspose.Words FOSS untuk .NET dapat membaca dan memodifikasi panel tugas ekstensi web (Office Add-in) yang tertanam dalam file .docx — metadata yang mengaitkan dokumen dengan Office Add-in dan mengikatnya ke data dokumen — melalui Document.WebExtensionTaskPanes dan model objek TaskPane/WebExtension.

Panel Tugas

Document.WebExtensionTaskPanes mengembalikan TaskPaneCollection dari objek TaskPane. Setiap TaskPane menjelaskan di mana dan bagaimana panel add-in dipasang: DockState (sebuah TaskPaneDockState dari Right atau Left), Row, Width, IsLocked, dan IsVisible, serta properti WebExtension yang menautkan ke add-in itu sendiri.

Identitas dan Referensi Ekstensi Web

WebExtension mengidentifikasi add-in melalui Id dan IsFrozen, dan properti Reference-nya (sebuah WebExtensionReference) menampilkan Id, Version, Store, dan StoreType (sebuah WebExtensionStoreType seperti SPCatalog, Exchange, atau FileSystem) yang menggambarkan dari mana add-in didistribusikan. AlternateReferences berisi WebExtensionReferenceCollection referensi fallback.

Pengikatan dan Properti Kustom

WebExtension.Bindings adalah WebExtensionBindingCollection dari objek WebExtensionBinding, masing-masing dibangun sebagai new WebExtensionBinding(id, bindingType, appRef) dan menautkan bagian data dokumen ke add-in melalui WebExtensionBindingType (Matrix, Table, atau Text). WebExtension.Properties adalah WebExtensionPropertyCollection dari pasangan nama/nilai sederhana WebExtensionProperty, dibangun sebagai new WebExtensionProperty(name, value), digunakan untuk pengaturan khusus add-in yang tidak memerlukan binding penuh.

Keanggotaan Koleksi

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection, dan WebExtensionReferenceCollection semuanya berbagi perilaku koleksi dasar yang sama: Add(item), Clear(), Remove(index), GetEnumerator(), dan Count.

Tips dan Praktik Terbaik

Periksa TaskPane.IsVisible sebelum menganggap panel add-in sedang ditampilkan kepada pengguna — sebuah task pane dapat terdaftar tetapi tersembunyi.
WebExtensionReference.StoreType memberi tahu Anda dari mana add-in berasal (katalog, Exchange, sistem file, registri); gunakan untuk membedakan add-in pihak pertama dari add-in yang dimuat secara sampingan.
Binding menautkan WebExtensionBindingType tertentu (matriks, tabel, atau teks biasa) ke data dokumen — periksa tipe binding sebelum mengasumsikan bentuk data yang diharapkan oleh add-in.
Gunakan WebExtension.Properties untuk nilai konfigurasi add-in nama/nilai sederhana daripada mencoba menyimpannya di tempat lain dalam dokumen.

Masalah Umum

Masalah	Penyebab	Perbaikan
`Document.WebExtensionTaskPanes` kosong	Dokumen tidak memiliki Add-in Office yang terdaftar	Pastikan sumber `.docx` memang menyematkan panel tugas sebelum mengasumsikan API rusak
Tidak dapat mengetahui dari toko mana add-in berasal	`StoreType` tidak diperiksa	Baca `WebExtensionReference.StoreType` bersama `Store` untuk gambaran lengkap
Data binding tidak sesuai dengan harapan	Ketidaksesuaian tipe binding	Periksa `WebExtensionBinding.BindingType` (`Matrix`, `Table`, `Text`) sebelum menggunakan data yang terikat

FAQ

Bagaimana cara menemukan semua Office Add-ins yang terdaftar dalam sebuah dokumen?

Enumerasi Document.WebExtensionTaskPanes (sebuah TaskPaneCollection); setiap TaskPane.WebExtension memberi Anda identitas dan konfigurasi add-in.

Apakah saya dapat menambahkan binding ekstensi web baru atau properti dengan API ini?

Ya — koleksi (WebExtensionBindingCollection, WebExtensionPropertyCollection, dll.) mendukung Add(), sehingga Anda dapat membuat dan menambahkan objek WebExtensionBinding/WebExtensionProperty baru ke WebExtension yang ada.

Apa yang sebenarnya diikat oleh WebExtensionBinding?

Ini menghubungkan sebagian data dokumen ke add-in, menggunakan WebExtensionBindingType (Matrix, Table, atau Text) untuk mendeskripsikan bentuk data tersebut.

Bagaimana cara saya membaca pengaturan add-in khusus yang disimpan dalam dokumen?

Iterasikan WebExtension.Properties (sebuah WebExtensionPropertyCollection); setiap WebExtensionProperty mengekspos pasangan Name/Value.

API Reference Ringkasan

Kelas / Metode	Deskripsi
`Document.WebExtensionTaskPanes`	`TaskPaneCollection` panel tugas yang terdaftar dalam dokumen
`TaskPane`	Satu panel add-in: `DockState`, `Row`, `Width`, `IsVisible`, `IsLocked`, `WebExtension`
`WebExtension`	Identitas add-in: `Id`, `IsFrozen`, `Reference`, `Bindings`, `Properties`
`WebExtensionReference`	Sumber add-in: `Id`, `Version`, `Store`, `StoreType`
`WebExtensionBinding`	Menautkan data dokumen ke add-in melalui `WebExtensionBindingType`
`WebExtensionProperty`	Pengaturan add-in khusus sebagai pasangan `Name`/`Value`

Lihat Juga

Aspose.Words for .NET — Enterprise Documentation