إنشاء المستندات في C# باستخدام Mail Merge

Wordize for .NET هو حل احترافي للإنشاء الآلي للمستندات الشخصية باستخدام تقنية Mail Merge. تتيح فئة MailMerger لمطوري C# دمج قوالب المستندات الجاهزة مع البيانات من مصادر مختلفة للتوليد المجمع للفواتير والعقود والتقارير والرسائل الشخصية.

يوفر Wordize for .NET إمكانية استخدام تقنية Mail Merge مع القوالب في أي تنسيقات مدعومة: Word وPDF وHTML وMarkdown وغيرها. وهذا يتيح إنشاء مستندات شخصية بغض النظر عن تنسيق القالب الأصلي.

الإمكانيات الوظيفية:

ملء المستندات البسيط - تقوم طريقة Execute() بإنشاء مستندات شخصية عبر دمج القوالب الجاهزة مع مصادر البيانات الخارجية
إنشاء المحتوى الديناميكي - تقوم طريقة ExecuteWithRegions() بمعالجة العناصر المتكررة في القالب لإنشاء جداول وقوائم بأطوال متغيرة
التكامل مع مصادر البيانات المختلفة - دعم أنواع DataRow وDataTable وDataSet ومصفوفات القيم
الإعدادات المتقدمة - تدير فئة MailMergeOptions معاملات إنشاء المستندات: إزالة الفقرات الفارغة والمناطق والحقول غير المستخدمة، وقطع المساحات الزائدة، ودمج المناطق المكررة ومعاملات أخرى
إمكانية تصدير النتيجة إلى تنسيق رسومي - تقوم طريقة ExecuteToImages() بإرجاع النتيجة كمجموعة من الصور
دعم Fluent API لتشغيل الإنشاء من خلال MailMergerContext وسلسلة الطرق، مما يضيف وضوحاً لكود C#

سيناريوهات الاستخدام:

الإرسال المجمع للرسائل الشخصية والإشعارات مع بيانات فردية للمستلمين
إنشاء فواتير وعقود وعروض شخصية مع معلومات محددة لكل عميل
إنشاء مستندات من نماذج جاهزة: شهادات وإفادات ودعوات مع بيانات شخصية
الإنشاء الآلي لمستندات موحدة مع محتوى مختلف على أساس قواعد البيانات

اختبر إمكانيات الإنشاء البرمجي للمستندات الشخصية باستخدام تقنية Mail Merge في العرض التوضيحي التفاعلي المعروض على هذه الصفحة. لذلك، قم بتحميل قالب المستند، وملف نصي مع البيانات (CSV أو JSON أو XML)، وتشغيل العملية وتنزيل النتيجة المتولدة للتحقق. مقطع كود C# المقدم جاهز تماماً للاستخدام في مشروع .NET الخاص بك.

تشغيل الكود

تحميل قالب المستند

تحميل مصدر البيانات

اختر تنسيق الإخراج من القائمة

 
				
				
		
using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;

string json = File.ReadAllText("DataSource.json");
DataTable dataTable = JsonConvert.DeserializeObject(json);
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataTable);

										using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;

string json = File.ReadAllText("DataSource.json");
DataTable dataTable = JsonConvert.DeserializeObject(json);
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataTable);

										using System.Data;
using Newtonsoft.Json;
using Wordize.MailMerging;
using Wordize.Saving;

string json = File.ReadAllText("DataSource.json");
DataTable dataTable = JsonConvert.DeserializeObject(json);
var imageStreams = MailMerger.Execute("Input.docx", new ImageSaveOptions(SaveFormat.Pdf),  dataTable);

foreach (var (stream, page) in imageStreams.Select((s, i) => (s, i)))
{
    using var _ = stream;
    stream.Position = 0;
    
    using var file = File.Create($"Output_{page + 1}.pdf");
    stream.CopyTo(file);
}

					
using System.Data;
using Wordize.MailMerging;

DataSet dataSet = new DataSet();
dataSet.ReadXml("DataSource.xml");
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataSet.Tables[0]);

										using System.Data;
using Wordize.MailMerging;

DataSet dataSet = new DataSet();
dataSet.ReadXml("DataSource.xml");
MailMerger.Execute("Input.docx", "Output.pdf", SaveFormat.Pdf, dataSet.Tables[0]);

										using System.Data;
using Wordize.MailMerging;
using Wordize.Saving;

DataSet dataSet = new DataSet();
dataSet.ReadXml("DataSource.xml");
var imageStreams = MailMerger.Execute("Input.docx", new ImageSaveOptions(SaveFormat.Pdf),  dataSet.Tables[0]);

foreach (var (stream, page) in imageStreams.Select((s, i) => (s, i)))
{
    using var _ = stream;
    stream.Position = 0;
    
    using var file = File.Create($"Output_{page + 1}.pdf");
    stream.CopyTo(file);
}

					

				تشغيل الكود
			

كيفية إنشاء مستندات شخصية في C#

قم بتوصيل Wordize for .NET بمشروع C# الخاص بك
اقرأ ملف البيانات، قم بإلغاء التسلسل إلى DataTable واستدعِ Execute()، مع تحديد قالب المستند وملف الإخراج وتنسيق الحفظ ومصدر البيانات
احصل على المستندات الشخصية المُنشأة