DOM का उपयोग करके मर्ज फ़ील्ड डालें

परिचय

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

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

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

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

चरण 1: अपना प्रोजेक्ट सेटअप करें

सबसे पहले, आइए विजुअल स्टूडियो में एक नया प्रोजेक्ट सेटअप करें।

  1. विजुअल स्टूडियो खोलें.
  2. नया प्रोजेक्ट बनाएँ: फ़ाइल > नया > प्रोजेक्ट पर जाएँ। C# कंसोल ऐप चुनें।
  3. अपने प्रोजेक्ट को नाम दें: अपने प्रोजेक्ट को एक सार्थक नाम दें और बनाएँ पर क्लिक करें।

चरण 2: Aspose.Words स्थापित करें

Aspose.Words का उपयोग करने के लिए, आपको इसे अपने प्रोजेक्ट में जोड़ना होगा। यह NuGet पैकेज मैनेजर के माध्यम से किया जा सकता है।

  1. NuGet पैकेज मैनेजर खोलें: सॉल्यूशन एक्सप्लोरर में अपने प्रोजेक्ट पर राइट-क्लिक करें, फिर NuGet पैकेज प्रबंधित करें चुनें।
  2. Aspose.Words खोजें: NuGet पैकेज मैनेजर में, “Aspose.Words” खोजें।
  3. पैकेज स्थापित करें: अपने प्रोजेक्ट में Aspose.Words जोड़ने के लिए इंस्टॉल पर क्लिक करें।

चरण 3: नामस्थान आयात करें

Aspose.Words का उपयोग शुरू करने के लिए, आपको अपने प्रोजेक्ट में आवश्यक नेमस्पेस आयात करने की आवश्यकता है। आप इसे इस प्रकार कर सकते हैं:

using System;
using Aspose.Words;
using Aspose.Words.Fields;

चरण 4: अपना दस्तावेज़ आरंभ करें

अब जब सब कुछ सेट हो गया है, तो आइए एक नया वर्ड दस्तावेज़ बनाएं और डॉक्यूमेंटबिल्डर को आरंभ करें।

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

// दस्तावेज़ और दस्तावेज़बिल्डर बनाएँ.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

चरण 5: कर्सर को विशिष्ट पैराग्राफ़ पर ले जाएँ

इसके बाद, हमें कर्सर को दस्तावेज़ में उस विशिष्ट पैराग्राफ़ पर ले जाना होगा जहाँ हम मर्ज फ़ील्ड सम्मिलित करना चाहते हैं।

Paragraph para = (Paragraph) doc.GetChild(NodeType.Paragraph, 0, true);
builder.MoveTo(para);

चरण 6: मर्ज फ़ील्ड डालें

मर्ज फ़ील्ड डालना सरल है। हम इसका उपयोग करेंगेInsertField की विधिDocumentBuilder कक्षा।

// फ़ील्ड मर्ज फ़ील्ड सम्मिलित करें.
FieldMergeField field = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, false);

चरण 7: मर्ज फ़ील्ड कॉन्फ़िगर करें

मर्ज फ़ील्ड डालने के बाद, आप अपनी आवश्यकताओं के अनुसार इसे कॉन्फ़िगर करने के लिए विभिन्न गुण सेट कर सकते हैं।

field.FieldName = "Test1";
field.TextBefore = "Test2";
field.TextAfter = "Test3";
field.IsMapped = true;
field.IsVerticalFormatting = true;

चरण 8: दस्तावेज़ को अपडेट करें और सहेजें

अंत में, यह सुनिश्चित करने के लिए फ़ील्ड को अपडेट करें कि सभी सेटिंग्स लागू हैं और दस्तावेज़ को सहेजें।

// फ़ील्ड को अद्यतन करें.
field.Update();

// दस्तावेज़ सहेजें.
doc.Save(dataDir + "InsertionChampMergeChamp.docx");

निष्कर्ष

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

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

मर्ज फ़ील्ड क्या है?

मर्ज फ़ील्ड दस्तावेज़ में एक प्लेसहोल्डर होता है जिसे डेटा स्रोत, जैसे डेटाबेस या CSV फ़ाइल, से डेटा द्वारा गतिशील रूप से प्रतिस्थापित किया जा सकता है।

क्या मैं Aspose.Words का निःशुल्क उपयोग कर सकता हूँ?

Aspose.Words एक निःशुल्क परीक्षण प्रदान करता है जिसे आप डाउनलोड कर सकते हैंयहाँदीर्घकालिक उपयोग के लिए, आपको लाइसेंस खरीदना होगा।

मैं Aspose.Words के लिए अस्थायी लाइसेंस कैसे प्राप्त करूं?

आप Aspose वेबसाइट से अस्थायी लाइसेंस प्राप्त कर सकते हैंयहाँ.

Aspose.Words .NET के कौन से संस्करण समर्थित हैं?

Aspose.Words .NET के कई संस्करणों का समर्थन करता है, जिसमें .NET Framework, .NET Core और .NET Standard शामिल हैं।

मैं Aspose.Words के लिए API दस्तावेज़ कहां पा सकता हूं?

API दस्तावेज़ उपलब्ध हैयहाँ.