إنشاء مستندات وورد مخصصة باستخدام C# .NET | ملحق دمج البريد Aspose.Words

إن أتمتة إنشاء المستندات أمر بالغ الأهمية للشركات التي تتطلع إلى إنشاء تقارير ديناميكية وفواتير ورسائل. مع Aspose.Words Mail Merge for .NET، يمكنك ملء قوالب Word بكفاءة باستخدام بيانات من مصادر متنوعة، بما في ذلك الكائنات وCSV وJSON وXML. ستوجهك هذه الإرشادات خلال استخدام دمج البريد في C# لعمليات إنشاء مستندات مبسطة وأوتوماتيكية، مع التركيز على إنشاء مستندات Word الديناميكية باستخدام C# .NET.

جدول المحتويات

• نظرة عامة على دمج البريد لـ .NET
• إنشاء مستندات من مصادر بيانات متنوعة
  • استخدام كائنات C#
  • استخدام XML
  • استخدام JSON
  • استخدام CSV
• أفضل الممارسات لدمج البريد
• الأسئلة الشائعة

نظرة عامة على دمج البريد لـ .NET

يمكن لمكون Aspose.Words Mail Merge for .NET تمكين المطورين من إنشاء مستندات مخصصة من قوالب محددة مسبقًا تحتوي على حقول دمج. تم تصميم هذه التكامل للاستخدام السلس ضمن بيئات .NET، مما يوفر إمكانيات لـ:

• ملء القوالب ديناميكيًا بالبيانات، دعمًا لـ إنشاء مستندات Word بإطار عمل .NET.
• تنفيذ إنشاء مستندات بكميات كبيرة بكفاءة، مستفيدًا من حل دمج البريد لـ .NET لمستندات Word.
• ضمان تنسيق متسق عبر المخرجات، مما يعزز أفضل الممارسات لقوالب مستندات Word في C#.

الميزات الرئيسية:

1. دعم متعدد المصادر: استخدام البيانات من الكائنات وقواعد البيانات وXML وJSON وCSV لإنشاء مستندات Word مخصصة باستخدام C#.
2. أداء عالي: التعامل بكفاءة مع مجموعات بيانات كبيرة وعمليات بالجملة لـ إنشاء مستندات Word الديناميكية باستخدام .NET Core.
3. قوالب قابلة للتخصيص: إنشاء قوالب مع عناصر نائبة لإدخال البيانات، مستفيدًا من قدرات أتمتة دمج البريد في Word لـ .NET.

الإعداد

للبدء، قم بتثبيت Aspose.Words باستخدام NuGet:

PM> Install-Package Aspose.Words

إنشاء مستند Word من قالب باستخدام كائنات C#

لنبدأ بملء قالب Word باستخدام كائنات C#. سنقوم بإنشاء مستند Word (DOC/DOCX) مع العناصر النائبة التالية:

<<[sender.Name]>> يقول: "<<[sender.Message]>>."

في هذا المثال، sender هو مثيل لفئة سنستخدمها لملء القالب باستخدام نهج C# لإنشاء مستند Word من قاعدة بيانات.

بعد ذلك، سنستخدم محرك التقارير الخاص بـ Aspose.Words لإنشاء مستند Word من القالب ومثيل فئة Sender من خلال اتباع الخطوات التالية:

1. إنشاء مثيل من فئة Document وتهيئته بمسار قالب Word.
2. إنشاء وتهيئة كائن من فئة Sender.
3. إنشاء مثيل من فئة ReportingEngine.
4. ملء القالب باستخدام ReportingEngine.BuildReport()، الذي يأخذ مثيل Document ومصدر البيانات واسم مصدر البيانات كمعلمات.
5. حفظ مستند Word الناتج باستخدام Document.Save().

إليك نموذج الكود الذي يوضح كيفية إنشاء مستند Word من قالب في C#.

المخرجات

إنشاء مستند Word من مصدر بيانات XML في C#

لإنشاء مستند Word من مصدر بيانات XML، سنستخدم قالب Word أكثر تعقيدًا مع العناصر النائبة التالية:

<<foreach [in persons]>>الاسم: <<[Name]>>, العمر: <<[Age]>>, تاريخ الميلاد: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
متوسط العمر: <<[persons.Average(p => p.Age)]>>

مصدر بيانات XML المستخدم في هذا المثال موضح أدناه.

لإنشاء مستند Word من مصدر بيانات XML، اتبع الخطوات التالية:

1. إنشاء مثيل من فئة Document وتهيئته بمسار قالب Word.
2. إنشاء مثيل من فئة XmlDataSource وتهيئته بمسار ملف XML.
3. إنشاء مثيل من فئة ReportingEngine.
4. استخدام طريقة ReportingEngine.BuildReport() لملء قالب Word.
5. حفظ مستند Word الناتج باستخدام طريقة Document.Save().

إليك نموذج الكود الذي يوضح كيفية إنشاء مستند Word من مصدر بيانات XML في C#.

المخرجات

إنشاء مستند Word من مصدر بيانات JSON في C#

بعد ذلك، دعنا نستكشف كيفية إنشاء مستند Word باستخدام مصدر بيانات JSON. في هذا المثال، سنقوم بإنشاء قائمة من العملاء مقسمة حسب مديريهم. سيبدو قالب Word كما يلي:

<<foreach [in managers]>>المدير: <<[Name]>>
العقود:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

مصدر بيانات JSON المقابل الذي سنستخدمه لملء القالب موضح أدناه:

لإنشاء مستند Word من JSON، سنستخدم فئة JsonDataSource لتحميل مصدر البيانات، وستتبع الخطوات المتبقية الهيكل السابق. إليك نموذج الكود الذي يوضح كيفية إنشاء مستند Word من قالب JSON في C#.

المخرجات

إنشاء مستند Word من مصدر بيانات CSV في C#

لإنشاء مستند Word من مصدر CSV، سنستخدم قالب Word التالي:

<<foreach [in persons]>>الاسم: <<[Column1]>>, العمر: <<[Column2]>>, تاريخ الميلاد: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
متوسط العمر: <<[persons.Average(p => p.Column2)]>>

سيتم ملء القالب باستخدام بيانات CSV التالية:

الآن، دعنا نستعرض كود C#. تظل الخطوات كما هي باستثناء اختلاف رئيسي واحد: سنستخدم فئة CsvDataSource لتحميل بيانات CSV. نموذج الكود التالي يوضح كيفية إنشاء مستند Word من مصدر بيانات CSV.

المخرجات

جرب Aspose.Words لـ .NET مجانًا

يمكنك تجربة Aspose.Words لـ .NET باستخدام ترخيص مؤقت مجاني.

الخاتمة

في هذه المقالة، تعلمت كيفية إنشاء مستندات Word من القوالب باستخدام C#. لقد استكشفت كيفية الاستفادة من مصادر البيانات المختلفة مثل الكائنات وXML وJSON وCSV لـ إنشاء مستندات ديناميكية في .NET. لمزيد من المعلومات حول قدرات معالجة قوالب Word في .NET، يمكنك الغوص في التوثيق ولا تتردد في التواصل من خلال المنتدى.