परिचय

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

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

कोडिंग शुरू करने से पहले, निम्नलिखित तैयारी अवश्य कर लें:

1. .NET के लिए Aspose.Cells: इसे डाउनलोड करें यहाँ या इसे NuGet के माध्यम से स्थापित करें।
2. XML-मैप की गई एक्सेल फ़ाइल: आपको एक एक्सेल फ़ाइल (.xlsx) की आवश्यकता होगी जिसमें XML मैप पहले से मौजूद हो।
3. विकास परिवेश: यह मार्गदर्शिका विजुअल स्टूडियो के लिए तैयार की गई है, लेकिन अन्य C# संपादक भी काम करेंगे।
4. Aspose लाइसेंस: आप एक अस्थायी लाइसेंस प्राप्त कर सकते हैं यहाँ यदि आपको इसकी आवश्यकता है.

अपना विकास वातावरण स्थापित करना

अपनी कोड फ़ाइल में आवश्यक नामस्थान आयात करके प्रारंभ करें:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Diagnostics;
using System.Collections;

इन पैकेजों को आयात करके, आप कार्यपुस्तिका और उसके कार्यपत्रकों तक पहुंचने और उनमें हेरफेर करने के लिए अपना वातावरण स्थापित कर रहे हैं।

चरण 1: अपनी एक्सेल फ़ाइल लोड करें

सबसे पहले, आपको XML मैपिंग वाली एक एक्सेल फ़ाइल लोड करनी होगी:

// स्रोत फ़ाइल के लिए निर्देशिका परिभाषित करें
string sourceDir = "Your Document Directory"; // तदनुसार पथ को अद्यतन करें

// एक्सेल फ़ाइल लोड करें
Workbook workbook = new Workbook(sourceDir + "sampleXmlMapQuery.xlsx");

यहाँ, Workbook आपकी संपूर्ण एक्सेल फ़ाइल का प्रतिनिधित्व करता है, जिसे आप इसके फ़ाइलपथ का उपयोग करके लोड करते हैं।

चरण 2: XML मानचित्र तक पहुँचें

एक बार आपकी फ़ाइल लोड हो जाने पर, कार्यपुस्तिका के भीतर XML मानचित्र तक पहुँचें:

// कार्यपुस्तिका में पहले XML मानचित्र तक पहुँचें
XmlMap xmlMap = workbook.Worksheets.XmlMaps[0];

यह आपकी कार्यपुस्तिका से पहला XML मानचित्र प्राप्त करता है। यदि आपकी कार्यपुस्तिका में एकाधिक मानचित्र हैं, तो आवश्यकतानुसार अनुक्रमणिका समायोजित करें।

चरण 3: वर्कशीट का चयन करें

इसके बाद, उस वर्कशीट तक पहुँचें जिसमें मैप किया गया XML डेटा है:

// कार्यपुस्तिका में पहली वर्कशीट तक पहुँचें
Worksheet worksheet = workbook.Worksheets[0];

इस मामले में, हम पहली वर्कशीट का चयन कर रहे हैं, लेकिन आप आवश्यकतानुसार किसी अन्य को भी आसानी से लक्षित कर सकते हैं।

चरण 4: XML मानचित्र पर क्वेरी करें

अब, XML पथ का उपयोग करके XML मैप को क्वेरी करते हैं। उदाहरण के लिए, यदि आप किसी XML पथ से डेटा पुनर्प्राप्त करना चाहते हैं, तो XML पथ का उपयोग करें। /MiscData पथ, आप करेंगे:

// पथ का उपयोग करके XML मानचित्र को क्वेरी करें
Console.WriteLine("Querying XML Map from Path - /MiscData");
ArrayList results = worksheet.XmlMapQuery("/MiscData", xmlMap);

यह विधि XML पथ लेती है और संबंधित डेटा को ArrayList में पुनः प्राप्त करती है।

चरण 5: क्वेरी परिणाम प्रदर्शित करें

अब जब आपके पास क्वेरी किया गया डेटा है, तो आइए परिणाम को कंसोल पर प्रिंट करें:

// क्वेरी के परिणाम आउटपुट करें
foreach (var result in results)
{
    Console.WriteLine(result);
}

यह लूप आपको XML पथ से प्राप्त सभी आइटम देखने की अनुमति देता है।

चरण 6: नेस्टेड XML पथ को क्वेरी करें

आप अपनी क्वेरी को और ज़्यादा विशिष्ट डेटा के लिए बेहतर बना सकते हैं। उदाहरण के लिए, अगर आपकी रुचि रंग संबंधी जानकारी में है, तो /MiscData/row/Color, आप अपनी क्वेरी को इस तरह समायोजित करेंगे:

// नेस्टेड XML पथ की क्वेरी करना
Console.WriteLine("Querying XML Map from Path - /MiscData/row/Color");
results = worksheet.XmlMapQuery("/MiscData/row/Color", xmlMap);

चरण 7: नेस्टेड क्वेरी परिणाम प्रदर्शित करें

अंत में, आइए इस विशिष्ट पथ से डेटा प्रदर्शित करें:

// नेस्टेड पथ क्वेरी के परिणाम आउटपुट करें
foreach (var result in results)
{
    Console.WriteLine(result);
}

यह लूप नेस्टेड क्वेरी से प्रत्येक आइटम को प्रिंट करेगा, तथा आपको लक्षित डेटा दिखाएगा।

निष्कर्ष

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

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

क्या मैं एक ही एक्सेल वर्कबुक में एकाधिक XML फ़ाइलों को मैप कर सकता हूँ?

हां, Aspose.Cells एक ही कार्यपुस्तिका में एकाधिक XML मानचित्रों के प्रबंधन का समर्थन करता है।

यदि मानचित्र में XML पथ मौजूद न हो तो क्या होगा?

यदि आप किसी अमान्य पथ के बारे में पूछताछ करते हैं, तो XmlMapQuery विधि एक खाली ArrayList लौटाएगी.

क्या .NET के लिए Aspose.Cells का उपयोग करने के लिए लाइसेंस की आवश्यकता है?

हाँ, आपको पूर्ण कार्यक्षमता के लिए लाइसेंस की आवश्यकता है। मुफ्त परीक्षण और एक अस्थायी लाइसेंस उपलब्ध हैं.

क्या मैं पूछे गए डेटा को नई एक्सेल फ़ाइल में सहेज सकता हूँ?

बिल्कुल! आप डेटा निकाल सकते हैं और उसे किसी अन्य Excel फ़ाइल में सहेज सकते हैं या Aspose.Cells द्वारा समर्थित विभिन्न स्वरूपों में निर्यात कर सकते हैं।

क्या एक्सेल (.xlsx) के अलावा अन्य प्रारूपों में XML मानचित्रों की क्वेरी समर्थित है?

XML मैपिंग मुख्यतः .xlsx फ़ाइलों में समर्थित है, तथा अन्य प्रारूपों के लिए कार्यक्षमताएं सीमित हो सकती हैं।