چگونه ردیف‌هایی به جدول در سند 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, "Text in Cell " + i));
    row.Cells.Add(cell);
}

مرحله 7: افزودن ردیف‌ها به انتها

از RowCollection.Add برای اضافه کردن ردیف‌ها به جدول استفاده کنید.

tableToAddRowsTo.Rows.Add(row);

مرحله 8: درج ردیف‌ها در یک ایندکس خاص

از RowCollection.Insert برای درج ردیف‌ها در یک ایندکس خاص استفاده کنید.

tableToAddRowsTo.Rows.Insert(1, row);

مرحله 9: ذخیره سند به‌روز شده

سند را با ردیف‌های اضافه شده دوباره ذخیره کنید.

MSWordDocument.Save(@"Added Rows to Table in MS Word.docx");

کد نمونه برای افزودن ردیف به جدول در Word

در زیر کد کامل برای افزودن ردیف به یک جدول آورده شده است:

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

// Get the Table by index
Table tableToAddRowsTo = MSWordDocument.FirstSection.Body.Tables[0];

// Create a new Row class object
Row row = new Row(MSWordDocument);

// Add three Cells to Row's cells collection
for (int i = 0; i < 3; i++)
{
    Cell cell = new Cell(MSWordDocument);
    cell.AppendChild(new Paragraph(MSWordDocument));
    cell.FirstParagraph.Runs.Add(new Run(MSWordDocument, "Text in Cell " + i));
    row.Cells.Add(cell);
}

// Insert new Row after the first Row
tableToAddRowsTo.Rows.Insert(1, row);

// Clone an existing Row from Table
Row cloneOfRow = (Row)tableToAddRowsTo.FirstRow.Clone(true);

// Remove all content from all Cells
foreach (Cell cell in cloneOfRow)
{
    cell.RemoveAllChildren();
    cell.EnsureMinimum();
}

// Add multiple empty rows to the end of table
for (int i = 0; i < 10; i++)
{
    Row emptyRow = (Row)cloneOfRow.Clone(true);
    tableToAddRowsTo.Rows.Add(emptyRow);
}

// Save updated document
MSWordDocument.Save(@"output.docx");

نتیجه‌گیری

این آموزش نشان داد که چگونه می‌توان ردیف‌هایی به یک جدول در یک سند MS Word با استفاده از C# اضافه کرد. با دنبال کردن این مراحل، می‌توانید به طور مؤثر جداول را در اسناد Word به صورت برنامه‌نویسی مدیریت و تغییر دهید.

 فارسی