परिचय
Aspose.Words FOSS for .NET अब उपलब्ध है: एक मुफ्त, ओपन-सोर्स .NET लाइब्रेरी जो शुद्ध C# में Word दस्तावेज़ बनाना, पढ़ना और संपादित करना संभव बनाती है, बिना Microsoft Word इंस्टॉलेशन की आवश्यकता के। यह उन डेवलपर्स के लिए है जिन्हें टेम्प्लेट से रिपोर्ट और पत्र उत्पन्न करने की जरूरत है, मौजूदा .docx फ़ाइलों से सामग्री पढ़ने और पुनर्संरचना करने की, या प्रोसेसिंग पाइपलाइन के हिस्से के रूप में Word दस्तावेज़ों को Markdown या साधारण टेक्स्ट में बदलने की, बिना किसी वाणिज्यिक SDK का लाइसेंस खरीदे।.
लाइब्रेरी MIT लाइसेंस के तहत जारी की गई है और इसमें कोई नेटिव डिपेंडेंसी नहीं है — सब कुछ मैनेज्ड कोड में चलता है। यह .NET Standard 2.0 को टार्गेट करती है, इसलिए यह .NET Framework 4.6.2+ और .NET 6, 8, और 10 पर, Windows, Linux, और macOS पर काम करती है। इसे NuGet के माध्यम से इंस्टॉल करें, या एक ही dotnet build कमांड से स्रोत से लाइब्रेरी बनाएं (नीचे Quick Start देखें)।.
एक सामान्य नई ओपन-सोर्स दस्तावेज़ लाइब्रेरी से इसे अलग करने वाला पहलू यह है कि यह पुनर्लेखन या रैपर नहीं है।
Aspose.Words FOSS for .NET वास्तविक Aspose.Words कोडबेस है — वही दस्तावेज़ इंजन जिसने 2003 से उत्पादन में Word दस्तावेज़ों को प्रोसेस किया है — जिसे एक मुक्त, MIT-लाइसेंस्ड कोर में घटाया गया है।
वे डेवलपर्स जो इस संस्करण से आगे बढ़ते हैं और पेज लेआउट, रेंडरिंग, या अतिरिक्त फॉर्मेट कन्वर्टर की आवश्यकता रखते हैं, वाणिज्यिक Aspose.Words के लिए .NET उनके कोड को फिर से लिखे बिना, क्योंकि यह वही आधारभूत API है।.
मुख्य विशेषताएँ
दस्तावेज़ निर्माण और संपादन
new Document() और उच्च‑स्तरीय DocumentBuilder का उपयोग करके शून्य से दस्तावेज़ बनाएं, या new Document(fileName) के साथ मौजूदा .docx फ़ाइलें खोलें। DocumentBuilder क्रमिक लेखन विधियाँ जैसे Write(), Writeln(), InsertParagraph(), और InsertBreak() प्रदान करता है, साथ ही स्वरूपण गुण (Font, ParagraphFormat, PageSetup) जो सामग्री के सम्मिलित होने पर लागू होते हैं। निचले स्तर की पहुँच के लिए, Section, Paragraph, Run, और Table नोड्स के माध्यम से दस्तावेज़ ट्री को सीधे चलें, या सभी नोड प्रकारों को एक ही पास में प्रोसेस करने के लिए DocumentVisitor को सबक्लास करें।.
टेबल्स और सूचियाँ
टेबल Table, Row, और Cell नोड्स से बनते हैं। Table.SetBorders(), Table.SetShading(), और Table.AutoFit() पूरे टेबल को एक साथ फॉर्मेट करते हैं, जबकि Table.Rows और प्रति‑रो Cell एक्सेस अधिक सटीक नियंत्रण देती है। क्रमांकित और बुलेटेड सूचियाँ ListCollection और ListFormat के माध्यम से बनती हैं: ListFormat.ApplyBulletDefault() या ApplyNumberDefault() के साथ बिल्ट‑इन स्टाइल लागू करें, या ListCollection.Add() के साथ कस्टम लिस्ट डिफ़िनिशन रजिस्टर करें।.
ट्रैक्ड परिवर्तन और दस्तावेज़ सुरक्षा
संपादन से पहले Document.StartTrackRevisions() को कॉल करें ताकि इन्सर्शन, डिलीशन और फॉर्मेटिंग बदलावों को रिकॉर्ड किया जा सके, फिर उन्हें RevisionCollection के माध्यम से निरीक्षण, स्वीकृति या अस्वीकृति करें (AcceptAll(), RejectAll(), Accept(criteria), Reject(criteria)), या Document.AcceptAllRevisions() से सब कुछ एक साथ स्वीकारें। Document.Protect() पासवर्ड प्रोटेक्शन या रीड‑ओनली एन्फोर्समेंट को DocumentSecurity एन्युम (ReadOnlyEnforced, ReadOnlyRecommended, PasswordProtected, और संबंधित मान) का उपयोग करके लागू करता है, और Document.Unprotect() इसे उलट देता है।.
फ़ील्ड, मैक्रो, और डिजिटल सिग्नेचर
फ़ील्ड मूल्यांकन इंजन FieldDate (the DATE field) और FieldDocProperty (the DOCPROPERTY field) को Document.UpdateFields() के माध्यम से स्थान पर अपडेट करता है — ऐसे फ़ील्ड जो पेज लेआउट पर निर्भर होते हैं, जैसे पेज नंबर, प्लेसहोल्डर मान देते हैं क्योंकि पेज लेआउट इस संस्करण का हिस्सा नहीं है। DOCM और DOTM फ़ाइलें अपने VBA प्रोजेक्ट्स को बरकरार रखते हुए राउंड‑ट्रिप करती हैं। मौजूदा डिजिटल सिग्नेचर को DigitalSignatureCollection और DigitalSignature (IsValid, SubjectName, IssuerName, SignTime) के माध्यम से जाँचा जा सकता है ताकि यह पुष्टि की जा सके कि दस्तावेज़ पर साइन है और उसे छेड़छाड़ नहीं की गई है; नई सिग्नेचर बनाना इस संस्करण का हिस्सा नहीं है।.
चार्ट्स
DocumentBuilder.InsertChart() के साथ एक दस्तावेज़ में चार्ट डालें, फिर लौटाए गए Chart ऑब्जेक्ट के माध्यम से उसके डेटा सीरीज़ को कॉन्फ़िगर करें।.
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
त्वरित प्रारंभ
Aspose.Words .NET के लिए FOSS NuGet द्वारा उपलब्ध है:
dotnet add package Aspose.Words.FOSSइसके बजाय स्रोत से बनाना चाहते हैं तो:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release
फिर अपने एप्लिकेशन से Aspose.Words.csproj के लिए एक प्रोजेक्ट रेफ़रेंस जोड़ें। रेफ़रेंस स्थापित होने पर, एक चार्ट के साथ दस्तावेज़ बनाएं और उसे DOCX में सहेजें:
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Console.WriteLine("Saved chart.docx");
समर्थित प्रारूप
| फ़ॉर्मेट | एक्सटेंशन | पढ़ें | लिखें |
|---|---|---|---|
| DOCX | .docx | ✓ | ✓ |
| DOCM | .docm | ✓ | ✓ |
| DOTX | .dotx | ✓ | ✓ |
| DOTM | .dotm | ✓ | ✓ |
| फ़्लैट OPC (सभी वेरिएंट) | (विभिन्न) | ✓ | ✓ |
| Markdown | .md | ✓ | ✓ |
| Text | .txt | ✓ | ✓ |
इस संस्करण में जानबूझकर पेज लेआउट और रेंडरिंग को बाहर रखा गया है — कोई PDF, XPS, या इमेज एक्सपोर्ट नहीं, और कोई प्रिंटिंग नहीं, जिसका अर्थ है कि पेज नंबर जैसी लेआउट‑निर्भर फ़ील्ड मान प्लेसहोल्डर के रूप में दिखेंगे न कि गणना किए जाएंगे। अतिरिक्त फ़ॉर्मेट कन्वर्टर (DOC, RTF, ODT, HTML, EPUB, MHTML, MOBI, AZW3, और WordML) नहीं पढ़े या लिखे जाते हैं, और मेल मर्ज निष्पादन, LINQ रिपोर्टिंग, दस्तावेज़ तुलना, नई डिजिटल सिग्नेचर बनाना, और एम्बेडेड‑फ़ॉन्ट सबसेटिंग शामिल नहीं हैं। ये वही सबसिस्टम हैं जिन्हें व्यावसायिक कोडबेस से हटाया गया है ताकि यह संस्करण मुफ्त बना रहे।.
ओपन सोर्स एवं लाइसेंसिंग
Aspose.Words FOSS for .NET MIT लाइसेंस के तहत जारी किया गया है, व्यावसायिक और व्यक्तिगत दोनों उपयोग के लिए मुफ्त है, बिना किसी रॉयल्टी या पुनर्वितरण प्रतिबंध के। पूर्ण स्रोत GitHub में उपलब्ध है Aspose.Words FOSS for .NET रिपॉजिटरी.
