دمج البريد يجعل من السهل إنشاء مستندات مخصصة بكميات كبيرة، مثل الرسائل، والبريد الإلكتروني، والفواتير، أو الشهادات. تبدأ بقالب وتملؤه باستخدام بيانات من جدول بيانات. كل صف في ملف Excel ينشئ مستندًا جديدًا بالتفاصيل الصحيحة في الأماكن المناسبة. إنها طريقة ذكية لأتمتة المهام المتكررة مثل إرسال الفواتير أو إنشاء التقارير. في هذا المنشور، سنظهر لك كيفية إجراء دمج البريد من Excel باستخدام C#. لنبدأ.
هذا المقال يغطي المواضيع التالية:
- C# مكتبة دمج البريد في Excel
- كيف يعمل دمج المراسلات مع Aspose.Cells؟
- دليل خطوة بخطوة لأداء دمج البريد من Excel
- Complete C# Code to Mail Merge Data
- موارد مجانية
- الأسئلة المتكررة
مكتبة دمج البريد في Excel بلغة C#
سنستخدم واجهة برمجة التطبيقات Aspose.Cells for .NET لإجراء دمج البريد من Excel في C#. إنها توفر أدوات قوية للعمل مع ملفات Excel مباشرة في الكود الخاص بك. يسمح للمطورين بإنشاء وقراءة وتحديث جداول البيانات بسهولة. يمكنك أيضًا التعامل مع مهام متقدمة مثل دمج البريد بدون عناء. تجعل المكتبة أتمتة Excel سريعة ومرنة وموثوقة.
للبدء باستخدام Aspose.Cells for .NET، اتبع تعليمات التثبيت البسيطة هذه:
- يرجى تنزيله من releases.
- قم بتثبيت المكتبة باستخدام NuGet Package Manager مع الأمر التالي:
PM> Install-Package Aspose.Cells
كيف تعمل عملية دمج البريد مع Aspose.Cells؟
لا تدعم Aspose.Cells “دمج البريد” بنفس الطريقة التي تدعمها Word.فهي تضيف دمج البريد إلى Excel باستخدام Smart Markers.تعمل هذه العلامات كأدلة في جدول البيانات الخاص بك، وتستبدل المكتبة بها البيانات الحقيقية أثناء وقت التشغيل. بينما تعالج كل صف من مصدر بياناتك، تملأ النموذج وتوسع المحتوى تلقائيًا، مما يتيح لك إنشاء وثائق مخصصة بالكامل باستخدام بضعة أسطر فقط من كود C#.
&=DataSource.ColumnName
خلال المعالجة، تقوم Aspose.Cells باستبدال هذه بالقيم الفعلية من DataTable، List<T>، أو أي IEnumerable. على سبيل المثال، تستبدل المكتبة &=Data.Name بالقيم من عمود الاسم في جدول البيانات.
إعداد قالب Excel
إنشاء ملف Excel (مثل Template.xlsx) مع علامات ذكية. إليك تخطيط عينة:
| الاسم | البريد الإلكتروني | المبلغ |
|---|---|---|
| &=Data.Name | &=Data.Email | &=Data.Amount |
خطوة بخطوة دليل لتنفيذ دمج البريد من Excel في C#
لإجراء دمج المراسلات من Excel باستخدام Aspose.Cells for .NET، ما عليك سوى اتباع الخطوات التالية:
الخطوة 1: تحميل قالب Excel
قم بتحميل ملف قالب Excel الذي يحتوي على علامات ذكية باستخدام فئة Workbook. تمثل فئة Workbook الملف Excel بالكامل (دفتر العمل).يعمل ملف القالب المحمل كتصميم لمخرجك المدمج.
Workbook workbook = new Workbook("Template.xlsx");
الخطوة 2: إنشاء جدول بيانات
هنا، نقوم بإنشاء جدول بيانات يحاكي مصدر بيانات Excel الخاص بك. يتطابق كل عمود مع علامة ذكية، ويمثل كل صف مجموعة واحدة من القيم للإدراج. تحتفظ فئة DataTable من System.Data بالبيانات التي تريد دمجها. يتطابق كل عمود مع علامة ذكية، ويقدم كل صف مجموعة فريدة من القيم.
DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");
dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1500);
الخطوة 3: ربط قالب Excel بمصدر البيانات
نستخدم فئة WorkbookDesigner لربط القالب بالبيانات. فئة WorkbookDesigner هي فئة خاصة في Aspose.Cells مصممة للتعامل مع العلامات الذكية وربط البيانات. تربط مصدر بياناتك (مثل DataTable) بقالب Excel. طريقة SetDataSource() تربط DataTable (Data) بالعلامات الذكية في دفتر العمل.
WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);
SetDataSource()يربط جدول البيانات (DataTable) بالعلامات الذكية (Smart Markers) في مصنف العمل (workbook)."Data"هو الاسم المستخدم في العلامات مثل&=Data.Name.
الخطوة 4: تنفيذ دمج البريد
بمجرد أن قمت بتعيين مصدر البيانات، فإن استدعاء Process() يملأ جميع العلامات الذكية بالقيم الحقيقية من DataTable. تنفذ هذه الأمر دمج البريد. يمر عبر العلامات الذكية ويستبدلها بالقيم الفعلية من مصدر البيانات.
designer.Process();
الخطوة 5: حفظ الملف
أخيراً، نقوم بحفظ الملف المكتمل مع دمج جميع البيانات فيه.
workbook.Save("MergedOutput.xlsx");
احفظ المخرجات المدمجة كملف PDF
يمكنك بسهولة حفظ مستند Excel المدمج كملف PDF مع سطر واحد من الشيفرة.
// Set PDF options
PdfSaveOptions options = new PdfSaveOptions();
// Save as PDF
workbook.Save("MergedDocument.pdf", SaveFormat.Pdf);
كود C# كامل لدمج البيانات عبر البريد
// حمّل قالب Excel
Workbook workbook = new Workbook("Template.xlsx");
// Create dummy data
DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");
dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1200);
// قم بتعيين مصدر البيانات
WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);
// معالجة العلامات الذكية (دمج البريد)
designer.Process();
// Save the output
workbook.Save("MergedOutput.xlsx");
Output
يحتوي ملف Excel الناتج على صف لكل إدخال مع بيانات مخصصة تم تعبئتها بدلاً من العلامات الذكية.
دمج البريد من Excel في C# - الإخراج
احصل على رخصة مجانية
احصل على ترخيص مؤقت مجاني يتيح لك اختبار جميع ميزات Aspose.Cells for .NET دون قيود. إنه مثالي إذا كنت تقيم واجهة برمجة التطبيقات لمهام الأتمتة مثل دمج البريد، وتقارير Excel، أو تصدير PDF.
دمج البريد من Excel إلى Excel: موارد مجانية
بالإضافة إلى دمج المراسلات في Excel، نقدم موارد متنوعة لمساعدتك في تعميق فهمك لـ Aspose.Cells for .NET. تحقق من وثائقنا، والدروس التعليمية، والمنتديات المجتمعية لمزيد من الأفكار.
الأسئلة المتداولة (FAQs)
Q1: هل يمكنني استخدام دمج البريد في Excel بدون تثبيت Microsoft Office؟
نعم، دمج البريد لا يتطلب Microsoft Office. تعمل Aspose.Cells بشكل مستقل وتعالج كل شيء من خلال واجهات برمجة التطبيقات الخاصة بها.
Q2: ما الفرق بين علامات الذكاء وحقول دمج الكلمات؟
تعمل العلامات الذكية داخل Excel وهي قابلة للتخصيص أكثر لتوسيع البيانات على مستوى الصفوف. حقول الدمج خاصة بـ Word.
Q3: هل يمكنني الدمج من Excel إلى Word باستخدام Aspose؟
نعم، لكنك ستحتاج إلى Aspose.Words لهذا السيناريو.
Q4: هل من الممكن أتمتة إنشاء PDF من الدمج في Excel؟
بالطبع. فقط احفظ المصنف النهائي بتنسيق PDF باستخدام Aspose.Cells.
خاتمة
دمج البريد من Excel يوفر طريقة قوية لإنشاء مستندات ديناميكية وشخصية باستخدام واجهة الجدول الحسابي المألوفة. في هذه التدوينة، قمنا بشرح كيفية دمج البريد من Excel باستخدام C#. من خلال استخدام علامات Aspose.Cells الذكية، تحصل على القدرة على أتمتة هذه العملية بالكامل وإنتاج آلاف الفواتير، والشهادات، أو أي تقارير مهيكلة.
إذا كان لديك أي أسئلة أو تحتاج إلى مزيد من المساعدة، فلا تتردد في التواصل معنا في منتدى الدعم المجاني.