संरचित दस्तावेज़ टैग रेंज XML मैपिंग प्रारंभ करें

परिचय

क्या आपने कभी किसी वर्ड डॉक्यूमेंट में XML डेटा को गतिशील रूप से सम्मिलित करना चाहा है? खैर, आप भाग्यशाली हैं! .NET के लिए Aspose.Words इस कार्य को आसान बनाता है। इस ट्यूटोरियल में, हम संरचित दस्तावेज़ टैग रेंज स्टार्ट XML मैपिंग में गहराई से गोता लगा रहे हैं। यह सुविधा आपको कस्टम XML भागों को सामग्री नियंत्रणों से बांधने की अनुमति देती है, जिससे यह सुनिश्चित होता है कि आपके दस्तावेज़ की सामग्री आपके XML डेटा के साथ सहजता से अपडेट हो। अपने दस्तावेज़ों को गतिशील मास्टरपीस में बदलने के लिए तैयार रहें।

आवश्यक शर्तें

इससे पहले कि हम कोडिंग भाग में जाएं, आइए सुनिश्चित करें कि आपके पास वह सब कुछ है जो आपको चाहिए:

1. Aspose.Words for .NET Library: सुनिश्चित करें कि आपके पास नवीनतम संस्करण है। आप इसे डाउनलोड कर सकते हैंयहाँ.
2. विकास वातावरण: विजुअल स्टूडियो या कोई अन्य IDE जो C# का समर्थन करता हो।
3. C# का बुनियादी ज्ञान: C# प्रोग्रामिंग से परिचित होना आवश्यक है।
4. वर्ड दस्तावेज़: काम करने के लिए एक नमूना वर्ड दस्तावेज़.

नामस्थान आयात करें

सबसे पहले, आइए आवश्यक नामस्थानों को आयात करें। इससे यह सुनिश्चित होगा कि हमारे पास .NET के लिए Aspose.Words में सभी आवश्यक क्लासेस और विधियों तक पहुँच है।

using System;
using Aspose.Words;
using Aspose.Words.Markup;
using System.Text;

चरण 1: अपनी दस्तावेज़ निर्देशिका सेट करें

हर प्रोजेक्ट को एक नींव की जरूरत होती है, है न? यहाँ, हम आपके दस्तावेज़ निर्देशिका के लिए पथ सेट करते हैं।

// आपके दस्तावेज़ निर्देशिका का पथ
string dataDir = "YOUR DOCUMENT DIRECTORY";

चरण 2: वर्ड दस्तावेज़ लोड करें

इसके बाद, हम Word दस्तावेज़ लोड करते हैं। यह वह दस्तावेज़ है जहाँ हम अपना XML डेटा डालेंगे।

Document doc = new Document(dataDir + "Multi-section structured document tags.docx");

चरण 3: कस्टम XML भाग जोड़ें

हमें एक XML भाग बनाना होगा जिसमें वह डेटा हो जिसे हम सम्मिलित करना चाहते हैं और उसे दस्तावेज़ के CustomXmlPart संग्रह में जोड़ना होगा। यह कस्टम XML भाग हमारे संरचित दस्तावेज़ टैग के लिए डेटा स्रोत के रूप में काम करेगा।

XML भाग बनाना

सबसे पहले, XML भाग के लिए एक अद्वितीय आईडी बनाएं और उसकी सामग्री को परिभाषित करें।

// डेटा युक्त XML भाग का निर्माण करें और उसे दस्तावेज़ के CustomXmlPart संग्रह में जोड़ें।
string xmlPartId = Guid.NewGuid().ToString("B");
string xmlPartContent = "<root><text>Text element #1</text><text>Text element #2</text></root>";
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(xmlPartId, xmlPartContent);

XML भाग सामग्री सत्यापित करें

यह सुनिश्चित करने के लिए कि XML भाग सही ढंग से जोड़ा गया है, हम इसकी सामग्री को प्रिंट करते हैं।

Console.WriteLine(Encoding.UTF8.GetString(xmlPart.Data));

चरण 4: एक संरचित दस्तावेज़ टैग बनाएँ

स्ट्रक्चर्ड डॉक्यूमेंट टैग (SDT) एक कंटेंट कंट्रोल है जो XML भाग से जुड़ सकता है। यहाँ, हम एक SDT बनाते हैं जो हमारे कस्टम XML भाग की सामग्री प्रदर्शित करेगा।

सबसे पहले, दस्तावेज़ में SDT रेंज प्रारंभ का पता लगाएं।

StructuredDocumentTagRangeStart sdtRangeStart = (StructuredDocumentTagRangeStart)doc.GetChild(NodeType.StructuredDocumentTagRangeStart, 0, true);

चरण 5: SDT के लिए XML मैपिंग सेट करें

अब, हमारे XML भाग को SDT से जोड़ने का समय आ गया है। XML मैपिंग सेट करके, हम निर्दिष्ट करते हैं कि XML डेटा का कौन सा भाग SDT में प्रदर्शित किया जाना चाहिए।

XPath XML भाग में उस विशिष्ट तत्व की ओर इंगित करता है जिसे हम प्रदर्शित करना चाहते हैं। यहाँ, हम दूसरे तत्व की ओर इशारा करते हैं<text> तत्व के भीतर<root> तत्व।

// हमारे StructuredDocumentTag के लिए मैपिंग सेट करें
sdtRangeStart.XmlMapping.SetMapping(xmlPart, "/root[1]/text[2]", null);

चरण 6: दस्तावेज़ सहेजें

अंत में, कार्रवाई में परिवर्तन देखने के लिए दस्तावेज़ को सहेजें। Word दस्तावेज़ में SDT अब निर्दिष्ट XML सामग्री प्रदर्शित करेगा।

doc.Save(dataDir + "WorkingWithSdt.StructuredDocumentTagRangeStartXmlMapping.docx");

निष्कर्ष

और अब यह हो गया! आपने .NET के लिए Aspose.Words का उपयोग करके Word दस्तावेज़ में XML भाग को संरचित दस्तावेज़ टैग में सफलतापूर्वक मैप कर लिया है। यह शक्तिशाली सुविधा आपको आसानी से गतिशील और डेटा-संचालित दस्तावेज़ बनाने में सक्षम बनाती है। चाहे आप रिपोर्ट, चालान या कोई अन्य दस्तावेज़ प्रकार बना रहे हों, XML मैपिंग आपके वर्कफ़्लो को महत्वपूर्ण रूप से सुव्यवस्थित कर सकती है।

अक्सर पूछे जाने वाले प्रश्न

वर्ड में संरचित दस्तावेज़ टैग क्या है?

संरचित दस्तावेज़ टैग, जिन्हें सामग्री नियंत्रण के रूप में भी जाना जाता है, Word दस्तावेज़ों में विशिष्ट प्रकार की सामग्री के लिए कंटेनर हैं। इनका उपयोग डेटा को बांधने, संपादन को प्रतिबंधित करने या दस्तावेज़ निर्माण में उपयोगकर्ताओं को मार्गदर्शन करने के लिए किया जा सकता है।

मैं XML भाग की सामग्री को गतिशील रूप से कैसे अद्यतन कर सकता हूँ?

आप XML भाग की सामग्री को संशोधित करके अपडेट कर सकते हैंxmlPartContent दस्तावेज़ में जोड़ने से पहले स्ट्रिंग को अपडेट करें। बस स्ट्रिंग को नए डेटा के साथ अपडेट करें और इसे दस्तावेज़ में जोड़ेंCustomXmlParts संग्रह।

क्या मैं एक ही दस्तावेज़ में एकाधिक XML भागों को अलग-अलग SDTs से जोड़ सकता हूँ?

हां, आप एक ही दस्तावेज़ में कई XML भागों को अलग-अलग SDTs से जोड़ सकते हैं। प्रत्येक SDT का अपना अनूठा XML भाग और XPath मैपिंग हो सकता है।

क्या जटिल XML संरचनाओं को SDTs में मैप करना संभव है?

बिल्कुल! आप विस्तृत XPath अभिव्यक्तियों का उपयोग करके जटिल XML संरचनाओं को SDTs में मैप कर सकते हैं जो XML भाग के भीतर वांछित तत्वों को सटीक रूप से इंगित करते हैं।

मैं किसी दस्तावेज़ से XML भाग कैसे हटा सकता हूँ?

आप कॉल करके XML भाग को हटा सकते हैंRemove विधि परCustomXmlParts संग्रह, पारितxmlPartId XML का वह भाग जिसे आप हटाना चाहते हैं.