ส่วนขยายเว็บ
ส่วนขยายเว็บ
คู่มือนี้แสดงวิธีการอ่านและแก้ไขเมตาดาต้าแผงงานของ Office Add-in ที่ฝังอยู่ในไฟล์ .docx ด้วย Aspose.Words FOSS สำหรับ .NET. Aspose.Words FOSS สำหรับ .NET สามารถอ่านและแก้ไขส่วนขยายเว็บ (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บอกคุณว่าแอดอินมาจากแหล่งใด (catalog, Exchange, file system, registry); ใช้เพื่อแยกแยะแอดอิน first-party จาก sideloaded add-ins.- การผูกลิงก์
WebExtensionBindingTypeเฉพาะ (matrix, table, หรือ plain text) กับข้อมูลในเอกสาร — ตรวจสอบประเภทการผูกก่อนสันนิษฐานว่าข้อมูลรูปแบบใดที่แอดอินคาดหวัง. - ใช้
WebExtension.Propertiesสำหรับค่าการกำหนดค่าแอดอินแบบชื่อ/ค่าแบบง่าย แทนการพยายามเก็บไว้ในที่อื่นของเอกสาร.
ปัญหาที่พบบ่อย
| ปัญหา | สาเหตุ | วิธีแก้ไข |
|---|---|---|
Document.WebExtensionTaskPanes เป็นค่าว่าง | เอกสารไม่มี Office Add-ins ที่ลงทะเบียน | ยืนยันว่าแหล่งที่มาของ .docx จริง ๆ แล้วฝัง task pane ก่อนที่จะสมมติว่า API มีปัญหา |
| ไม่สามารถบอกได้ว่า add-in มาจากร้านค้าใด | StoreType ไม่ได้ตรวจสอบ | อ่าน WebExtensionReference.StoreType ควบคู่กับ Store เพื่อให้ได้ภาพรวมครบถ้วน |
| ข้อมูลการผูกไม่ตรงกับความคาดหวัง | ประเภท Binding ไม่ตรงกัน | ตรวจสอบ WebExtensionBinding.BindingType (Matrix, Table, Text) ก่อนใช้ข้อมูลที่ผูก |
FAQ
ฉันจะค้นหา Office Add-ins ทั้งหมดที่ลงทะเบียนในเอกสารได้อย่างไร?
เรียกลำดับ Document.WebExtensionTaskPanes (a TaskPaneCollection); แต่ละ TaskPane.WebExtension จะให้ข้อมูลตัวตนและการกำหนดค่าของแอดอินแก่คุณ.
ฉันสามารถเพิ่มการผูกเว็บเอกซ์เทนชันใหม่หรือคุณสมบัติด้วย API นี้ได้หรือไม่?
ใช่ — คอลเลกชัน (WebExtensionBindingCollection, WebExtensionPropertyCollection, เป็นต้น) รองรับ Add() ดังนั้นคุณสามารถสร้างและเพิ่มวัตถุ WebExtensionBinding/WebExtensionProperty ใหม่ลงใน WebExtension ที่มีอยู่ได้.
จริง ๆ แล้ว WebExtensionBinding ผูกกับอะไร?
มันเชื่อมส่วนหนึ่งของข้อมูลในเอกสารกับแอดอินโดยใช้ WebExtensionBindingType (Matrix, Table หรือ Text) เพื่ออธิบายรูปแบบของข้อมูลนั้น.
ฉันจะอ่านการตั้งค่าแอดอินแบบกำหนดเองที่เก็บไว้ในเอกสารได้อย่างไร?
วนซ้ำ WebExtension.Properties (เป็น WebExtensionPropertyCollection); แต่ละ WebExtensionProperty จะเปิดเผยคู่ Name/Value.
API Reference สรุป
| คลาส / เมธอด | คำอธิบาย |
|---|---|
Document.WebExtensionTaskPanes | TaskPaneCollection ของ task panes ที่ลงทะเบียนในเอกสาร |
TaskPane | หนึ่งแผงส่วนเสริม: DockState, Row, Width, IsVisible, IsLocked, WebExtension |
WebExtension | ตัวตนของส่วนเสริม: Id, IsFrozen, Reference, Bindings, Properties |
WebExtensionReference | แหล่งที่มาของส่วนเสริม: Id, Version, Store, StoreType |
WebExtensionBinding | เชื่อมโยงข้อมูลเอกสารกับส่วนเสริมผ่าน WebExtensionBindingType |
WebExtensionProperty | การตั้งค่าแอดอินแบบกำหนดเองเป็นคู่ Name/Value |
