הרחבות אינטרנט
הרחבות אינטרנט
מדריך זה מציג כיצד לקרוא ולשנות מטא-נתוני סרגל משימות של תוסף Office המוטמע בקובץ .docx באמצעות Aspose.Words FOSS עבור .NET. Aspose.Words FOSS עבור .NET יכול לקרוא ולשנות את הרחבת האינטרנט (תוסף Office) של סרגלי המשימות המוטמעים בקובץ .docx — המטא-נתונים שמקשרים מסמך עם תוסף Office וקושרים אותו לנתוני המסמך — דרך 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לפני שאתה מניח שהחלון של התוסף מוצג כעת למשתמש — חלון משימה יכול být רשום אך מוסתר. WebExtensionReference.StoreTypeמודיע לך מאיפה הגיע התוסף (קטלוג, Exchange, מערכת קבצים, רישום); השתמש בו כדי להבדיל בין תוספים של צד ראשון לתוספים שהוטענו באופן צדדי.- קישורים מחברים
WebExtensionBindingTypeספציפי (מטריצה, טבלה, או טקסט פשוט) לנתוני המסמך — בדוק את סוג הקישור לפני שאתה מניח איזו צורת נתונים מצפה התוסף. - השתמש ב-
WebExtension.Propertiesעבור ערכי תצורת תוסף פשוטים של שם/ערך במקום לנסות לאחסן אותם במקומות אחרים במסמך.
בעיות נפוצות
| בעיה | סיבה | תיקון |
|---|---|---|
Document.WebExtensionTaskPanes ריק | למסמך אין תוספי Office רשומים | ודא שהמקור .docx אכן משלב לוח משימות לפני שאתה מניח שה-API פגום |
| לא ניתן לדעת מאיזו חנות הגיע התוסף | StoreType לא נבדק | קרא את WebExtensionReference.StoreType לצד Store לקבלת התמונה המלאה |
| נתוני הקישור אינם תואמים לציפיות | אי התאמה בסוג הקישור | בדוק את 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 (a WebExtensionPropertyCollection); כל WebExtensionProperty חושף זוג Name/Value.
API Reference סיכום
| מחלקה / מתודה | תיאור |
|---|---|
Document.WebExtensionTaskPanes | TaskPaneCollection של לוחות משימות שנרשמו במסמך |
TaskPane | פאנל תוסף אחד: DockState, Row, Width, IsVisible, IsLocked, WebExtension |
WebExtension | זהות התוסף: Id, IsFrozen, Reference, Bindings, Properties |
WebExtensionReference | מקור התוסף: Id, Version, Store, StoreType |
WebExtensionBinding | מקשר נתוני מסמך לתוסף באמצעות WebExtensionBindingType |
WebExtensionProperty | הגדרת תוסף מותאם אישית כזוג Name/Value pair |
