VBA प्रोजेक्ट्स
VBA प्रोजेक्ट्स
यह गाइड दिखाता है कि कैसे Aspose.Words FOSS for .NET के साथ मैक्रो-सक्षम दस्तावेज़ में एम्बेडेड VBA प्रोजेक्ट की जाँच और संशोधन किया जाए। Aspose.Words FOSS for .NET VBA प्रोजेक्ट की जाँच और संशोधन कर सकता है जो मैक्रो-सक्षम दस्तावेज़ (.docm) में एम्बेडेड है — इसके मॉड्यूल, स्रोत कोड, और लाइब्रेरी रेफ़रेंसेज़ — Document.VbaProject और VbaProject/VbaModule ऑब्जेक्ट मॉडल के माध्यम से। यह प्रोजेक्ट की जाँच और संपादन है, मैक्रो निष्पादन नहीं: Aspose.Words ने कभी भी व्यावसायिक उत्पाद या इस FOSS संस्करण में VBA रनटाइम शामिल नहीं किया है, इसलिए VBA कोड को डेटा के रूप में पढ़ा और संशोधित किया जाता है, न कि चलाया जाता है।
दस्तावेज़ के VBA प्रोजेक्ट तक पहुंचना
Document.VbaProject एक VbaProject लौटाता है, या null यदि दस्तावेज़ में VBA प्रोजेक्ट नहीं है। Document.HasMacros यह रिपोर्ट करता है कि VBA प्रोजेक्ट मौजूद है या नहीं, बिना आपको पहले VbaProject तक पहुँचने की आवश्यकता के। VbaProject.Name, CodePage, IsSigned, और IsProtected प्रोजेक्ट स्वयं का वर्णन करते हैं।
मॉड्यूल पढ़ना और संपादित करना
VbaProject.Modules एक VbaModuleCollection लौटाता है। नाम द्वारा इसे इंडेक्स करके किसी विशिष्ट मॉड्यूल (उदा. modules["ModuleName"]) को खोजें, या पूरी कलेक्शन को सूचीबद्ध करें। प्रत्येक VbaModule अपना Name, Type (एक VbaModuleType: DocumentModule, ProceduralModule, ClassModule, या DesignerModule) उजागर करता है, और — महत्वपूर्ण रूप से — अपना SourceCode एक लिखने योग्य स्ट्रिंग प्रॉपर्टी के रूप में प्रदान करता है, ताकि मॉड्यूल स्रोत को प्रोग्रामेटिक रूप से पढ़ा और पुनः लिखा जा सके। VbaModuleCollection.Add(vbaModule) और Remove(module) प्रोजेक्ट से मॉड्यूल जोड़ते या हटाते हैं।
लाइब्रेरी रेफ़रेंसेज़
VbaProject.References एक VbaReferenceCollection लौटाता है VbaReference वस्तुओं का — Automation प्रकार लाइब्रेरी और अन्य VBA प्रोजेक्ट्स जिनपर मैक्रो कोड निर्भर करता है। VbaReference.Type एक VbaReferenceType रिपोर्ट करता है (Registered, Project, Original, या Control), और LibId संदर्भित लाइब्रेरी को पहचानता है। VbaReferenceCollection.Remove(item) / RemoveAt(index) संदर्भों को हटाते हैं।
VBA प्रोजेक्ट को हटाना
Document.RemoveMacros() दस्तावेज़ से VBA प्रोजेक्ट को पूरी तरह हटाता है — यह उन दस्तावेज़ों की मैक्रो-रहित प्रति बनाने के लिए उपयोगी है जो मूल रूप से मैक्रो के साथ वितरित किए गए थे।
टिप्स और सर्वोत्तम प्रथाएँ
Document.HasMacrosको जांचेंDocument.VbaProjectको छूने से पहले ताकि उन दस्तावेज़ों के लिए null-हैंडलिंग से बचा जा सके जिनमें कभी मैक्रो नहीं थे।VbaModule.SourceCodeको साधारण टेक्स्ट के रूप में मानें — क्योंकि कोई VBA रनटाइम नहीं है, इसे संपादित करने से कोड का सत्यापन नहीं होता; विकृत VBA अभी भी राउंड-ट्रिप होगा, लेकिन सही तरीके से वर्ड में तब तक नहीं चलेगा जब तक इसे सुधारा न जाए।- उनके मॉड्यूल को संशोधित करने का प्रयास करने से पहले साइन किए गए या संरक्षित प्रोजेक्ट्स का पता लगाने के लिए
VbaProject.IsSigned/IsProtectedका उपयोग करें। Document.RemoveMacros()मैक्रो को हटाने का सबसे सरल तरीका है “clean” वितरण प्रति के लिए, प्रत्येक मॉड्यूल को मैन्युअली साफ़ करने के बजाय।
सामान्य मुद्दे
| समस्या | कारण | समाधान |
|---|---|---|
Document.VbaProject है null | दस्तावेज़ में कोई VBA प्रोजेक्ट नहीं है | पहले Document.HasMacros की जाँच करें, फिर VbaProject सदस्यों तक पहुँचें |
संपादन के बाद SourceCode में मैक्रो चलने की अपेक्षा | Aspose.Words में VBA निष्पादन इंजन नहीं है | इस API का उपयोग केवल मैक्रो स्रोत और संरचना को पढ़ने/परिवर्तित करने के लिए करें; परिणामी दस्तावेज़ को VBA रनटाइम वाले वातावरण में चलाएँ, जैसे Microsoft Word, ताकि कोड निष्पादित हो सके। |
नाम से VbaModuleCollection को इंडेक्स करने पर कुछ नहीं मिलता है। | मॉड्यूल नाम मेल नहीं खाता (केस या सटीक वर्तनी)। | VbaProject.Modules को सूचीबद्ध करके सटीक मॉड्यूल नाम की पुष्टि करें। |
FAQ
क्या Aspose.Words FOSS for .NET दस्तावेज़ में VBA मैक्रो चला सकता है?
नहीं। न तो इस संस्करण में और न ही व्यावसायिक Aspose.Words उत्पाद में VBA निष्पादन इंजन शामिल है — VBA प्रोजेक्ट को डेटा (मॉड्यूल स्रोत, रेफ़रेंसेज़, प्रोजेक्ट मेटाडेटा) के रूप में पढ़ा और संशोधित किया जाता है, कभी निष्पादित नहीं किया जाता।
मैं मैक्रो का स्रोत कोड कैसे पढ़ूँ?
नाम (उदा. modules["ModuleName"]) द्वारा VbaProject.Modules को इंडेक्स करके मॉड्यूल प्राप्त करें, फिर उसकी SourceCode प्रॉपर्टी पढ़ें।
क्या मैं दस्तावेज़ में एक नया VBA मॉड्यूल जोड़ सकता हूँ?
हाँ — एक VbaModule बनाएं और उसे Add(vbaModule) के माध्यम से प्रोजेक्ट के VbaModuleCollection में जोड़ें।
मैं किसी दस्तावेज़ को प्रोसेस करने से पहले यह कैसे जाँचूँ कि उसमें मैक्रो हैं या नहीं?
Document.HasMacros पढ़ें; यह true है यदि दस्तावेज़ में VBA प्रोजेक्ट है, बिना आपको पहले Document.VbaProject तक पहुँचने की आवश्यकता के।
मैं दस्तावेज़ से सभी मैक्रो कैसे हटा सकता हूँ?
Document.RemoveMacros() को कॉल करें।
API Reference सारांश
| क्लास / मेथड | विवरण |
|---|---|
Document.VbaProject | दस्तावेज़ का VbaProject, या null यदि इसमें कोई मैक्रो नहीं हैं। |
Document.HasMacros | क्या VBA प्रोजेक्ट मौजूद है |
VbaProject | Name, Modules, References, CodePage, IsSigned, IsProtected |
VbaModule | एक मॉड्यूल: Name, Type (VbaModuleType), लिखने योग्य SourceCode |
VbaModuleCollection | Add(), नाम द्वारा अनुक्रमणकर्ता, Remove(), Count |
VbaReference / VbaReferenceCollection | संदर्भित type libraries: Type (VbaReferenceType), LibId |
Document.RemoveMacros() | दस्तावेज़ से VBA प्रोजेक्ट को हटा देता है |
