كيفية إضافة صفوف إلى جدول في مستند MS Word باستخدام C#

كيفية إضافة صفوف إلى جدول في مستند MS Word باستخدام C#

في هذا الدليل، ستتعلم كيفية إضافة صفوف إلى جدول في مستند MS Word برمجيًا باستخدام C#. ستقوم بإضافة صفوف في فهرس محدد وإدراج عدة صفوف فارغة في نهاية الجدول.

فوائد إضافة صفوف إلى الجداول في مستندات Word

  1. إدارة المحتوى الديناميكية:
    • تعديل الجداول الموجودة بسهولة لتناسب البيانات الجديدة.
  2. المرونة:
    • ضبط هياكل الجداول برمجيًا دون تعديلات يدوية.
  3. الأتمتة:
    • إدارة بيانات الجدول بكفاءة من خلال سكريبتات مؤتمتة.

المتطلبات المسبقة: إعداد البيئة

  1. تأكد من تثبيت Visual Studio أو أي IDE خاص بـ .NET.
  2. تأكد من توفر مكتبة Aspose.Words عبر NuGet.

دليل خطوة بخطوة لإضافة صفوف إلى جدول في Word

الخطوة 1: تثبيت مكتبة Aspose.Words

قم بتثبيت حزمة Aspose.Words باستخدام مدير الحزم NuGet.

Install-Package Aspose.Words

الخطوة 2: استيراد المساحات الاسمية اللازمة

قم بتضمين مساحات Aspose.Words و Aspose.Words.Tables في مشروعك.

using Aspose.Words;
using Aspose.Words.Tables;

الخطوة 3: فتح مستند Word

قم بتحميل مستند MS Word الموجود.

Document MSWordDocument = new Document(@"MS Word.docx");

الخطوة 4: الوصول إلى الجدول

احصل على الجدول بواسطة فهرسه من المستند.

Table tableToAddRowsTo = MSWordDocument.FirstSection.Body.Tables[0];

الخطوة 5: إنشاء صف أو استنساخه

قم بإنشاء صف جديد أو استنساخ صف موجود من الجدول.

Row row = new Row(MSWordDocument);

الخطوة 6: إضافة خلايا إلى الصف

قم بإضافة خلايا ونص إلى الصف.

for (int i = 0; i < 3; i++) 
{
    Cell cell = new Cell(MSWordDocument);
    cell.AppendChild(new Paragraph(MSWordDocument));
    cell.FirstParagraph.Runs.Add(new Run(MSWordDocument, "نص في الخلية " + i));
    row.Cells.Add(cell);
}

الخطوة 7: إضافة صفوف إلى النهاية

استخدم RowCollection.Add لإلحاق الصفوف بالجدول.

tableToAddRowsTo.Rows.Add(row);

الخطوة 8: إدراج صفوف في فهرس محدد

قم بإدراج صفوف في فهرس محدد باستخدام RowCollection.Insert.

tableToAddRowsTo.Rows.Insert(1, row);

الخطوة 9: حفظ المستند المحدث

قم بإعادة حفظ المستند مع الصفوف المضافة.

MSWordDocument.Save(@"تم إضافة الصفوف إلى الجدول في MS Word.docx");

مثال على الكود لإضافة صفوف إلى جدول في Word

فيما يلي الكود الكامل لإضافة صفوف إلى جدول:

// فتح مستند MS Word
Document MSWordDocument = new Document(@"input.docx");

// الحصول على الجدول بواسطة الفهرس
Table tableToAddRowsTo = MSWordDocument.FirstSection.Body.Tables[0];

// إنشاء كائن صف جديد
Row row = new Row(MSWordDocument);

// إضافة ثلاثة خلايا إلى مجموعة خلايا الصف
for (int i = 0; i < 3; i++)
{
    Cell cell = new Cell(MSWordDocument);
    cell.AppendChild(new Paragraph(MSWordDocument));
    cell.FirstParagraph.Runs.Add(new Run(MSWordDocument, "نص في الخلية " + i));
    row.Cells.Add(cell);
}

// إدراج صف جديد بعد الصف الأول
tableToAddRowsTo.Rows.Insert(1, row);

// استنساخ صف موجود من الجدول
Row cloneOfRow = (Row)tableToAddRowsTo.FirstRow.Clone(true);

// إزالة جميع المحتويات من جميع الخلايا
foreach (Cell cell in cloneOfRow)
{
    cell.RemoveAllChildren();
    cell.EnsureMinimum();
}

// إضافة عدة صفوف فارغة إلى نهاية الجدول
for (int i = 0; i < 10; i++)
{
    Row emptyRow = (Row)cloneOfRow.Clone(true);
    tableToAddRowsTo.Rows.Add(emptyRow);
}

// حفظ المستند المحدث
MSWordDocument.Save(@"output.docx");

الخاتمة

لقد أوضح هذا الدليل كيفية إضافة صفوف إلى جدول في مستند MS Word باستخدام C#. من خلال اتباع هذه الخطوات، يمكنك إدارة وتعديل الجداول داخل مستندات Word برمجيًا بفعالية.

 عربي