वेब एक्सटेंशन
वेब एक्सटेंशन
यह गाइड दिखाता है कि कैसे .docx फ़ाइल में एम्बेडेड Office Add-in टास्क पेन मेटाडेटा को Aspose.Words FOSS for .NET के साथ पढ़ा और संशोधित किया जाए। Aspose.Words FOSS for .NET .docx फ़ाइल में एम्बेडेड वेब एक्सटेंशन (Office Add-in) टास्क पेन को पढ़ और संशोधित कर सकता है — वह मेटाडेटा जो किसी दस्तावेज़ को 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आपको बताता है कि ऐड-इन कहाँ से प्राप्त हुआ (कैटलॉग, एक्सचेंज, फ़ाइल सिस्टम, रेजिस्ट्री); इसका उपयोग प्रथम-पक्षीय और साइडलोडेड ऐड-इन में अंतर करने के लिए करें।- बाइंडिंग्स एक विशिष्ट
WebExtensionBindingType(मैट्रिक्स, टेबल, या साधारण टेक्स्ट) को दस्तावेज़ डेटा से जोड़ती हैं — बाइंडिंग प्रकार की जाँच करें इससे पहले कि आप अनुमान लगाएँ कि ऐड-इन किस रूप के डेटा की अपेक्षा करता है। - दस्तावेज़ में कहीं और उन्हें संग्रहीत करने की कोशिश करने के बजाय सरल नाम/मान ऐड-इन कॉन्फ़िगरेशन मानों के लिए
WebExtension.Propertiesका उपयोग करें।
सामान्य समस्याएँ
| समस्या | कारण | समाधान |
|---|---|---|
Document.WebExtensionTaskPanes खाली है | दस्तावेज़ में कोई Office Add-ins पंजीकृत नहीं हैं | स्रोत .docx वास्तव में एक टास्क पैन एम्बेड करता है, यह सुनिश्चित करें, इससे पहले कि आप मानें कि API टूट गया है |
| यह निर्धारित नहीं कर पा रहा हूँ कि कोई ऐड-इन किस स्टोर से आया है | StoreType जाँच नहीं किया गया | पूरा चित्र पाने के लिए WebExtensionReference.StoreType को Store के साथ पढ़ें |
| बाइंडिंग डेटा अपेक्षाओं से मेल नहीं खाता | बाइंडिंग प्रकार का बेमेल | बाउंड डेटा का उपयोग करने से पहले WebExtensionBinding.BindingType (Matrix, Table, Text) जाँचें |
FAQ
मैं किसी दस्तावेज़ में पंजीकृत सभी Office Add-ins कैसे खोजूँ?
सूचीबद्ध करें Document.WebExtensionTaskPanes (एक TaskPaneCollection); प्रत्येक TaskPane.WebExtension आपको add-in की पहचान और कॉन्फ़िगरेशन देता है।
क्या मैं इस API के साथ एक नया वेब एक्सटेंशन बाइंडिंग या प्रॉपर्टी जोड़ सकता हूँ?
हां — संग्रह (WebExtensionBindingCollection, WebExtensionPropertyCollection, आदि) Add() का समर्थन करते हैं, इसलिए आप मौजूदा WebExtension में नए WebExtensionBinding/WebExtensionProperty ऑब्जेक्ट बना और जोड़ सकते हैं।
WebExtensionBinding वास्तव में क्या बाइंड करता है?
यह दस्तावेज़ के डेटा के एक हिस्से को add-in से जोड़ता है, एक WebExtensionBindingType (Matrix, Table, या Text) का उपयोग करके उस डेटा के आकार को वर्णित करता है।
मैं दस्तावेज़ में संग्रहीत कस्टम ऐड-इन सेटिंग्स को कैसे पढ़ूँ?
इटरेट WebExtension.Properties (एक 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 जोड़ी के रूप में |
