كيفية إضافة صفوف إلى جدول في مستند MS Word باستخدام C#
في هذا الدليل، ستتعلم كيفية إضافة صفوف إلى جدول في مستند MS Word برمجيًا باستخدام C#. ستقوم بإضافة صفوف في فهرس محدد وإدراج عدة صفوف فارغة في نهاية الجدول.
فوائد إضافة صفوف إلى الجداول في مستندات Word
- إدارة المحتوى الديناميكية:
- تعديل الجداول الموجودة بسهولة لتناسب البيانات الجديدة.
- المرونة:
- ضبط هياكل الجداول برمجيًا دون تعديلات يدوية.
- الأتمتة:
- إدارة بيانات الجدول بكفاءة من خلال سكريبتات مؤتمتة.
المتطلبات المسبقة: إعداد البيئة
- تأكد من تثبيت Visual Studio أو أي IDE خاص بـ .NET.
- تأكد من توفر مكتبة 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 برمجيًا بفعالية.