إن توليد المستندات التلقائي أمر حاسم بالنسبة للشركات التي تسعى إلى إنشاء تقارير ديناميكية وفواتير ورسائل.مع Aspose.Words Mail Merge for .NET، يمكنك استيعاب قوالب Word بفعالية مع البيانات من مصادر مختلفة، بما في ذلك الكائنات، CSV، JSON، و XML.
جدول المحتوى
نظرة عامة على Mail Merge for .NET
يتيح المكون الإضافي Aspose.Words Mail Merge for .NET للمطورين إنشاء مستندات مخصصة من القوالب المحددة مسبقًا تحتوي على الحقول المدمجة:
- استيعاب القوالب الديناميكية مع البيانات، ودعم .NET الإطار توليد الوثيقة Word.
- تنفذ بفعالية توليد الوثائق الكبيرة، وتستفيد من حل التراكم البريدية .NET للوثائق Word.
- ضمان تنسيق متسق في جميع النتائج، وتعزيز C# Word نموذج المستند أفضل الممارسات.
الخصائص الرئيسية:
- دعم المصدر المتعدد: استخدم البيانات من الكائنات، قواعد البيانات، XML، JSON، و CSV لإنشاء مستندات Word المخصصة باستخدام C#.
- الأداء العالي: التعامل بفعالية مع مجموعات البيانات الكبيرة والعمليات الكبيرة لتوليد مستندات Word الديناميكية مع .NET Core.
- قوالب قابلة للتخصيص: قم بإنشاء قوالب مع حاملي المواقع لإدراج البيانات باستخدام إمكانيات .NET Word Mail Fusion Automation.
إعدادات
للبدء ، قم بتثبيت Aspose.Words باستخدام NuGet:
PM> Install-Package Aspose.Words
خلق مستند كلمة من القالب باستخدام كائنات C#
دعونا نبدأ بتسجيل قالب Word باستخدام كائنات C#، وسنقوم بإنشاء وثيقة Word (DOC/DOCX) مع المراكز التالية:
<<[sender.Name]>> says: "<<[sender.Message]>>."
في هذا المثال، إرسال هو مثال من الدرجة التي سنستخدمها لتسجيل القالب باستخدام C# تولد وثيقة Word من نهج قاعدة البيانات.
بعد ذلك، سوف نستخدم محرك الإبلاغ Aspose.Words لإنتاج وثيقة Word من القالب وعرض فئة Sender من خلال اتباع الخطوات التالية:
- إنشاء مثال على وثيقة تصنيف وإطلاقها مع مسار قوالب الكلمة.
- إنشاء ومبادرة كائن من فئة إرسال.
- فانصرفوا إلى ReportingEngine الطبقة.
- تخصيص النموذج باستخدام إحصائيات إحصائيات إحصائيات(), الذي يأخذ مثال الوثيقة ، مصدر البيانات ، واسم مصدر البيانات كمعايير.
- حفظ وثيقة Word التي تم إنشاؤها باستخدام أرشيف الوسم : Save().
إليك عينة الرمز التي تظهر كيفية توليد وثيقة Word من قالب في C#.
الخروج
خلق مستند Word من مصدر بيانات XML في C#
لإنشاء مستند Word من مصدر بيانات XML، وسوف نستخدم قالب Word أكثر تعقيدًا مع أصحاب المواقع التالية:
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Age)]>>
يتم عرض مصدر البيانات XML المستخدم في هذا المثال أدناه.
لإنشاء مستند Word من مصدر بيانات XML، اتبع هذه الخطوات:
- قم بإنشاء مثال من فئة Document وإطلاقه باستخدام مسار قالب Word.
- إنشاء مثال على XmlDataSource تصنيف وإطلاقها مع مسار ملف XML.
- قم بتشغيل فئة ReportingEngine.
- استخدم طريقة ReportingEngine.BuildReport() لتسجيل النموذج Word.
- حفظ وثيقة Word التي تم إنشاؤها باستخدام طريقة Document.Save.
إليك عينة الرمز التي تظهر كيفية توليد وثيقة Word من مصدر بيانات XML في C#.
الخروج
خلق مستند Word من مصدر بيانات JSON في C#
بعد ذلك، دعونا نلقي نظرة على كيفية إنشاء وثيقة Word باستخدام مصدر بيانات JSON. في هذا المثال، سنقوم بإنشاء قائمة بالعملاء المنقسمين من قبل مديريهم:
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
مصدر البيانات JSON المقابل الذي سنستخدمه لتسجيل النموذج هو أدناه:
لإنشاء مستند Word من JSON، سوف نستخدم JsonDataSource فئة تحميل مصدر البيانات، وسوف تتبع الخطوات المتبقية الهيكل السابق.هنا عينة الرمز التي تظهر كيفية توليد وثيقة Word من قالب JSON في C#.
الخروج
خلق مستند Word من مصدر البيانات CSV في C#
لإنشاء مستند Word من مصدر CSV، وسوف نستخدم القالب Word التالي:
<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Column2)]>>
سيتم نشر القالب باستخدام بيانات CSV التالية:
الآن، دعونا نلقي نظرة على رمز C#. تبقى الخطوات هي نفسها باستثناء الفرق الرئيسي: سوف نستخدم CsvDataSource فئة تحميل بيانات CSV. يظهر العينة الرمزية التالية كيفية توليد وثيقة Word من مصدر البيانات CSV.
الخروج
جرب Aspose.Words for .NET for مجانا
يمكنك محاولة Aspose.Words لـ .NET باستخدام مجانا الترخيص المؤقت.
استنتاجات
في هذه المقالة، تعلمت كيفية توليد مستندات Word من القوالب باستخدام C#. لقد استكشفت طريقة الاستفادة من مصادر البيانات المختلفة مثل الكائنات، XML، JSON، و CSV لتوليد المستند الديناميكية في .NET الوثائق, واشعر بالحرية للوصول إلى طريقنا المنتدى.
More in this category
- تحويل Word DOC/DOCX إلى PDF في C# .NET و Aspose.Words' Document Converter Plugin
- إنشاء رمز شريطي في مستندات وورد (.NET، C#) | قراءة رمز شريطي من وورد (.NET)
- استخراج الصور من مستندات Word في C# معالجة الصور التلقائية
- تلقائي التقارير باستخدام C# Mail Merge و Aspose.Words' Mail Merge Plugin
- العثور على واستبدال النص في مستندات الكلمة باستخدام C# تلقائي تحرير الكلمة
