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

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

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

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

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

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

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

  1. Open Visual Studio.
  2. Create a New Project: फ़ाइल > नया > प्रोजेक्ट पर जाएँ। एक C# कंसोल ऐप चुनें.
  3. Name Your Project: अपने प्रोजेक्ट को एक सार्थक नाम दें और Create पर क्लिक करें।

चरण 2: Aspose.Words इंस्टॉल करें

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

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

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

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

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

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

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

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

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

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

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

// कर्सर को पैराग्राफ़ पर ले जाएँ.
builder.MoveToParagraph(2, 0);

चरण 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 एप्लिकेशन अधिक शक्तिशाली और कुशल बन जाते हैं।

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

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

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

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

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

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

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

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

Aspose.Words .NET फ्रेमवर्क, .NET कोर और .NET स्टैंडर्ड सहित .NET के कई संस्करणों का समर्थन करता है।

5. मुझे Aspose.Words के लिए एपीआई दस्तावेज़ कहां मिल सकता है?

एपीआई दस्तावेज़ उपलब्ध है.यहाँ.