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

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

iTextSharp एक शक्तिशाली लाइब्रेरी है जो .NET प्लेटफॉर्म (C#, VB.NET, F#) पर PDF दस्तावेज़ बनाने और उनमें बदलाव करने के लिए उपयोग की जाती है। यह लोकप्रिय Java लाइब्रेरी iText का पोर्ट है और डेवलपर्स को PDF फ़ाइलों को बनाने, संशोधित करने और पढ़ने पर पूरा नियंत्रण देती है।

iTextSharp की मुख्य क्षमताएँ:

• शून्य से PDF दस्तावेज़ बनाना
• टेक्स्ट, इमेज, टेबल, लिस्ट जोड़ना
• फ़ॉन्ट के साथ काम करना (यूनिकोड और देवनागरी सहित)
• हाइपरलिंक, बुकमार्क, मेटाडेटा डालना
• एन्क्रिप्शन और पासवर्ड प्रोटेक्शन
• PDF फ़ाइलों को मर्ज और विभाजित करना
• वॉटरमार्क और हेडर/फुटर जोड़ना
• फॉर्म (AcroForms) के साथ काम करना

यह लाइब्रेरी कॉर्पोरेट एप्लिकेशन में रिपोर्ट, इनवॉइस, चालान, सर्टिफिकेट और अन्य दस्तावेज़ बनाने के लिए व्यापक रूप से उपयोग की जाती है। iTextSharp .NET Framework 2.0+ और .NET Core (iTextSharp.LGPLv2.Core के ज़रिए) को सपोर्ट करती है।

iTextSharp की इंस्टॉलेशन

.NET प्रोजेक्ट में iTextSharp इंस्टॉल करने के लिए NuGet Package Manager का उपयोग किया जाता है। लाइब्रेरी के कई वर्शन उपलब्ध हैं:

• iTextSharp (पुराना वर्शन 5.x, LGPL) — मुफ्त, लेकिन सीमाओं के साथ
• iTextSharp.LGPLv2.Core — .NET Core / .NET 5+ के लिए फोर्क
• iText7 (iText.LGPLv2.Core) — .NET के लिए iText 7 का नया वर्शन

Package Manager Console से इंस्टॉल करें:

Install-Package iTextSharp.LGPLv2.Core -Version 1.7.0

.NET CLI से इंस्टॉल करें:

dotnet add package iTextSharp.LGPLv2.Core --version 1.7.0

Visual Studio NuGet UI से इंस्टॉल करें:

1. प्रोजेक्ट पर राइट-क्लिक करें → "Manage NuGet Packages"
2. सर्च करें: "iTextSharp.LGPLv2.Core"
3. वर्शन चुनें और "Install" पर क्लिक करें

महत्वपूर्ण: देवनागरी और अन्य गैर-मानक फ़ॉन्ट के साथ काम करने के लिए अतिरिक्त सेटिंग्स की आवश्यकता होगी ("टिप्स" सेक्शन देखें)।

त्वरित शुरुआत: पहला PDF दस्तावेज़ बनाना

आइए "Hello, World!" टेक्स्ट के साथ PDF फ़ाइल बनाने का एक बुनियादी उदाहरण देखें:

using System.IO;
using iTextSharp.text;
using iTextSharp.text.pdf;

class Program
{
    static void Main()
    {
        // दस्तावेज़ बनाएं
        Document doc = new Document();
        
        // फ़ाइल में लिखने के लिए स्ट्रीम बनाएं
        using (FileStream fs = new FileStream("HelloWorld.pdf", FileMode.Create))
        {
            // PdfWriter का इंस्टेंस प्राप्त करें
            PdfWriter writer = PdfWriter.GetInstance(doc, fs);
            
            // दस्तावेज़ खोलें
            doc.Open();
            
            // टेक्स्ट के साथ पैराग्राफ जोड़ें
            doc.Add(new Paragraph("Hello, World!"));
            
            // दस्तावेज़ बंद करें
            doc.Close();
        }
        
        Console.WriteLine("PDF सफलतापूर्वक बन गया!");
    }
}

यह कोड एक्जीक्यूटेबल फ़ाइल वाले फ़ोल्डर में HelloWorld.pdf फ़ाइल बनाएगा। ध्यान दें कि अनुक्रम इस प्रकार है: Document बनाना → खोलना → कंटेंट जोड़ना → बंद करना।

iTextSharp के मुख्य तरीके और फंक्शन

लाइब्रेरी के 10 प्रमुख मेथड्स/क्लासेस को विस्तृत विवरण और उदाहरणों के साथ देखें।

1. Document (क्लास)

क्या करता है: यह PDF दस्तावेज़ को प्रस्तुत करता है। पेज, मार्जिन और ओरिएंटेशन को मैनेज करता है।

कंस्ट्रक्टर के पैरामीटर:

• Rectangle pageSize — पेज का आकार (जैसे, PageSize.A4)
• float marginLeft, marginRight, marginTop, marginBottom — मार्जिन

उदाहरण:

// लैंडस्केप ओरिएंटेशन और कस्टम मार्जिन के साथ A4 दस्तावेज़ बनाएं
Document doc = new Document(PageSize.A4.Rotate(), 50, 50, 30, 30);
doc.Open();
doc.Add(new Paragraph("लैंडस्केप ओरिएंटेशन"));
doc.Close();