إنشاء جدول من `DataTable`

غالبًا ما يقوم تطبيقك بسحب البيانات من قاعدة البيانات وتخزينها في شكل DataTable. يمكنك بسهولة إدراج هذه البيانات في مستندك كجدول جديد وتطبيق التنسيق بسرعة على الجدول بأكمله.

لاحظ أن الطريقة المفضلة لإدراج البيانات من DataTable إلى جدول المستندات هي باستخدام Mail Merge مع المناطق. يتم اقتراح التقنية المعروضة في هذه المقالة فقط إذا كنت غير قادر على إنشاء قالب مناسب مسبقًا لدمج البيانات معه، وبعبارة أخرى، إذا كنت تريد أن يحدث كل شيء برمجيًا.

باستخدام Aspose.Words، يمكنك بسهولة استرداد البيانات من قاعدة البيانات وتخزينها كجدول:

1. قم بإنشاء كائن DocumentBuilder جديد على Document الخاص بك.
2. ابدأ جدولاً جديدًا باستخدام DocumentBuilder.
3. إذا أردنا إدراج أسماء كل عمود من الأعمدة من DataTable كصف رأس، فقم بالتكرار خلال كل عمود بيانات واكتب أسماء الأعمدة في صف في الجدول.
4. قم بالتكرار خلال كل DataRow في ملف DataTable:
   1. قم بالتكرار خلال كل كائن في DataRow.
   2. أدخل الكائن في المستند باستخدام DocumentBuilder. تعتمد الطريقة المستخدمة على نوع الكائن الذي يتم إدراجه، على سبيل المثال DocumentBuilder.Writeln للنص وDocumentBuilder.InsertImage لمصفوفة البايت التي تمثل صورة.
   3. في نهاية معالجة DataRow، قم أيضًا بإنهاء الصف الذي تم إنشاؤه بواسطة DocumentBuilder باستخدام DocumentBuilder.EndRow.
5. بمجرد معالجة جميع الصفوف من DataTable، قم بإنهاء الجدول عن طريق الاتصال بـ DocumentBuilder.EndTable.
6. أخيرًا، يمكننا ضبط نمط الجدول المطلوب باستخدام إحدى خصائص الجدول المناسبة مثل Table.StyleIdentifier لتطبيق التنسيق تلقائيًا على الجدول بأكمله.

تقبل طريقة ImportTableFromDataTable كائن DocumentBuilder، وDataTable الذي يحتوي على البيانات وعلامة تحدد ما إذا كان عنوان العمود من DataTable متضمنًا في أعلى الجدول. تقوم هذه الطريقة بإنشاء جدول من هذه المعلمات باستخدام الموقع الحالي للمنشئ وتنسيقه. يوفر طريقة لاستيراد البيانات من DataTable وإدراجها في جدول جديد باستخدام DocumentBuilder.

يتم استخدام البيانات التالية في DataTable الخاص بنا في هذا المثال:

يوضح مثال التعليمات البرمجية التالي كيفية تنفيذ الخوارزمية المذكورة أعلاه في Aspose.Words:

يمكن بعد ذلك استدعاء الطريقة بسهولة باستخدام DocumentBuilder والبيانات الخاصة بك.

يوضح مثال التعليمات البرمجية التالي كيفية استيراد البيانات من DataTable وإدراجها في جدول جديد في المستند: