ClosedXML C# (.NET): तरीके, उदाहरण, इंस्टॉलेशन

ClosedXML का परिचय: यह क्या है और क्यों ज़रूरी है

ClosedXML एक शक्तिशाली open-source लाइब्रेरी है जो C# (.NET) भाषा के लिए बनाई गई है। इसका उपयोग Microsoft Excel फ़ाइलों (.xlsx, .xlsm, .xltx फ़ॉर्मेट) को बनाने, पढ़ने और एडिट करने के लिए किया जाता है। यह एक आसान object-oriented इंटरफ़ेस प्रदान करती है, जिससे आप Microsoft Office इंस्टॉल किए बिना या COM-ऑब्जेक्ट्स का उपयोग किए बिना स्प्रेडशीट के साथ काम कर सकते हैं।

यह लाइब्रेरी खासतौर पर इन कामों के लिए उपयोगी है:

रिपोर्टिंग ऑटोमेशन — डेटाबेस, API या अन्य स्रोतों से डेटा लेकर जटिल Excel रिपोर्ट तैयार करना
डेटा इंपोर्ट/एक्सपोर्ट — सिस्टमों के बीच टेबुलर डेटा की बल्क प्रोसेसिंग
टेम्पलेट बनाना — पहले से तैयार Excel टेम्पलेट्स को डेटा से भरना
फाइनेंशियल और एनालिटिकल कैलकुलेशन — फ़ॉर्मूले, पिवट टेबल और चार्ट के साथ काम करना
VBA से माइग्रेशन — मैक्रोज़ को आधुनिक C# में ट्रांसफर करना

ClosedXML Excel की लगभग सभी प्रमुख सुविधाओं को सपोर्ट करता है: सेल फ़ॉर्मेटिंग, सेल मर्ज करना, कंडीशनल फ़ॉर्मेटिंग, चार्ट, पिवट टेबल, डेटा वैलिडेशन, शीट प्रोटेक्शन और भी बहुत कुछ। सबसे अच्छी बात यह है कि यह लाइब्रेरी पूरी तरह से मेमोरी में काम करती है और सर्वर पर Excel इंस्टॉल होने की ज़रूरत नहीं है।

ClosedXML इंस्टॉलेशन

ClosedXML को इंस्टॉल करने के लिए NuGet Package Manager का उपयोग किया जाता है। नीचे सभी इंस्टॉलेशन तरीके दिए गए हैं:

.NET CLI के ज़रिए

dotnet add package ClosedXML

Package Manager Console (Visual Studio) के ज़रिए

Install-Package ClosedXML

NuGet Package Manager UI के ज़रिए

Visual Studio में अपना प्रोजेक्ट खोलें
प्रोजेक्ट पर राइट-क्लिक करें → "Manage NuGet Packages" चुनें
"ClosedXML" खोजें और "Install" बटन पर क्लिक करें

इंस्टॉलेशन की जाँच

इंस्टॉल करने के बाद अपने कोड में यह using-डायरेक्टिव जोड़ें:

using ClosedXML.Excel;

त्वरित शुरुआत: अपनी पहली Excel टेबल बनाएं

चलिए कर्मचारियों का एक सरल टेबल बनाते हैं और इसे फ़ाइल में सेव करते हैं:

using ClosedXML.Excel;

class Program
{
    static void Main(string[] args)
    {
        // नई वर्कबुक बनाएं
        using (var workbook = new XLWorkbook())
        {
            // वर्कशीट जोड़ें
            var worksheet = workbook.Worksheets.Add("कर्मचारी");

            // हेडर भरें
            worksheet.Cell("A1").Value = "आईडी";
            worksheet.Cell("B1").Value = "नाम";
            worksheet.Cell("C1").Value = "पद";
            worksheet.Cell("D1").Value = "वेतन";

            // डेटा भरें
            worksheet.Cell("A2").Value = 1;
            worksheet.Cell("B2").Value = "रवि कुमार";
            worksheet.Cell("C2").Value = "डेवलपर";
            worksheet.Cell("D2").Value = 150000;

            worksheet.Cell("A3").Value = 2;
            worksheet.Cell("B3").Value = "सीमा शर्मा";
            worksheet.Cell("C3").Value = "एनालिस्ट";
            worksheet.Cell("D3").Value = 120000;

            // हेडर को फ़ॉर्मेट करें
            var headerRange = worksheet.Range("A1:D1");
            headerRange.Style.Font.Bold = true;
            headerRange.Style.Fill.BackgroundColor = XLColor.LightBlue;

            // कॉलम की चौड़ाई ऑटो-एडजस्ट करें
            worksheet.Columns().AdjustToContents();

            // फ़ाइल सेव करें
            workbook.SaveAs("employees.xlsx");
        }

        Console.WriteLine("फ़ाइल सफलतापूर्वक बन गई!");
    }

यह उदाहरण employees.xlsx नामक फ़ाइल बनाता है जिसमें तीन पंक्तियों का डेटा और फ़ॉर्मेटेड हेडर होंगे।