درج یا حذف ردیف‌ها و ستون‌ها در اکسل با استفاده از C#

به عنوان یک توسعه‌دهنده C#، شما می‌توانید به راحتی سطرها و ستون‌ها را به طور برنامه‌نویسی در ورق‌های اکسل وارد یا حذف کنید. در این مقاله، شما خواهید آموخت که چگونه سطرها و ستون‌ها را در یک شیت اکسل با استفاده از C# وارد یا حذف کنید.

موضوعات زیر در این مقاله بحث شده‌اند/پوشش داده شده‌اند:

C# API برای وارد کردن یا حذف ردیف‌ها و ستون‌ها

برای وارد کردن یا حذف ردیف‌ها و ستون‌ها در یک Excel شیت، من از Aspose.Cells for .NET API استفاده می‌کنم. این یک API معروف برای دستکاری صفحات گسترده است که به شما امکان می‌دهد فایل‌های Excel را از درون برنامه‌های .NET خود ایجاد و پردازش کنید. این API به شما اجازه می‌دهد ردیف‌ها و ستون‌های منفرد یا چندگانه را در فایل‌های Excel وارد کنید. همچنین به شما این امکان را می‌دهد که ردیف‌ها و ستون‌ها را به‌صورت برنامه‌نویسی حذف کنید.

شما می‌توانید یا download DLL API را دانلود کنید یا آن را با استفاده از NuGet نصب کنید.

Install-Package Aspose.Cells

درج ردیف‌ها در ورق‌های اکسل با استفاده از C#

شما می‌توانید به صورت برنامه‌نویسی ردیف‌ها را در شیت‌های اکسل وارد کنید با دنبال کردن مراحل زیر:

  1. یک نمونه از کلاس Workbook با مسیر فایل ورودی ایجاد کنید.
  2. یک نمونه از کلاس Worksheet را ایجاد کنید.
  3. به کاربرگ از Worksheets مجموعه با استفاده از ایندکس آن دسترسی پیدا کنید.
  4. سطرها را با فراخوانی متد InsertRows() وارد کنید و اندیس سطری را که باید از آن شروع کنید و تعداد سطرهایی که باید وارد کنید را از قبل مشخص کنید.
  5. Call the Save() method with the output file path.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان چندین سطر را در یک برگه Excel با استفاده از C# وارد کرد.

// ایجاد یک شیء Workbook
// Opening the Excel file through the file stream
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین برگه کار در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// درج ۱۰ ردیف به کاربرگ شروع از ردیف سوم
worksheet.Cells.InsertRows(2, 10);

// ذخیره فایل اکسل ویرایش شده
workbook.Save(@"C:\Files\output.xlsx");
درج ردیف‌ها در ورق‌های اکسل با استفاده از C#

چندین ردیف در ورق‌های Excel با استفاده از C# وارد کنید.

به طور مشابه، می‌توانید یک ردیف منفرد را در یک شیت اکسل با استفاده از مثال کد زیر درج کنید.

// ایجاد یک شیء Workbook
// باز کردن فایل اکسل از طریق جریان فایل
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین شیت در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// درج یک ردیف در ورق کار در موقعیت ۳
worksheet.Cells.InsertRow(2);

// ذخیره فایل اکسل اصلاح‌شده
workbook.Save(@"C:\Files\output.xlsx");
Insert a single Row in Excel Worksheets using C#

یک ردیف واحد را در کاربرگ‌های اکسل با استفاده از C# وارد کنید

کلاس Workbook API نمایانگر یک ورک بوک اکسل است. شما می‌توانید یک مجموعه از تمام ورق‌های کاری موجود در یک ورک بوک را با استفاده از خاصیت Worksheets این کلاس به دست آورید. هر ورق کاری منفرد یک ورک بوک اکسل می‌تواند از مجموعه Worksheets’ با استفاده از ایندکس آن دسترسی پیدا کند. کلاس Worksheet نمایانگر یک ورق کاری منفرد است. این کلاس چندین خاصیت و متد را برای انجام عملیات مختلف بر روی ورق کاری ارائه می‌دهد. خاصیت Cells این کلاس نمایانگر مجموعه‌ای از سلول‌های موجود در ورق کاری است. کلاس Cells نمایانگر یک سلول فردی در داخل ورق کاری است.

متد InsertRow() کلاس Cells اجازه می‌دهد تا یک سطر تنها را در ایندکس مشخص شده وارد کنید. کلاس Cells همچنین متد InsertRows() را برای وارد کردن بیش از یک سطر به طور همزمان فراهم می‌کند. این متد ایندکس سطر را از جایی که باید سطرها را وارد کند و تعداد کل سطرهای جدیدی را که باید وارد شود به عنوان پارامترهای ورودی می‌گیرد.

روش Save() کلاس Workbook کتاب کار را در مسیر فایل مشخص شده به عنوان پارامتر ورودی ذخیره می‌کند.

درج ردیف‌ها با فرمت در کاربرگ‌های Excel با استفاده از C#

شما می‌توانید به‌طور برنامه‌نویسی سطرها را با فرمت‌بندی در برگه‌های اکسل وارد کنید با دنبال کردن مراحل زیر:

  1. یک نمونه از کلاس Workbook با مسیر فایل ورودی ایجاد کنید.
  2. یک نمونه از کلاس Worksheet را ایجاد کنید.
  3. به کاربرگ از Worksheets مجموعه با استفاده از ایندکس آن دسترسی پیدا کنید.
  4. یک نمونه از کلاس InsertOptions را ایجاد کنید.
  5. Set the CopyFormatType property
  6. Call the InsertRows() method with the row index, total rows to insert and pass the InsertOptions.
  7. متد Save() را با مسیر فایل خروجی فراخوانی کنید.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان ردیف‌هایی با فرمت در یک شیت اکسل با استفاده از C# درج کرد.

// ایجاد یک شیء Workbook
// باز کردن فایل Excel از طریق جریان فایل
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین ورق در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// تنظیم گزینه‌های فرمت‌بندی
InsertOptions insertOptions = new InsertOptions();
insertOptions.CopyFormatType = CopyFormatType.SameAsAbove;

// درج یک ردیف درworksheet در موقعیت سوم
worksheet.Cells.InsertRows(2, 1, insertOptions);

// ذخیره فایل Excel تغییر یافته
workbook.Save(@"C:\Files\output.xlsx");

کلاس InsertOptions API گزینه‌ها را در حین وارد کردن ردیف‌ها یا ستون‌ها نمایندگی می‌کند. ویژگی CopyFormatType از این کلاس نوع فرمت کپی‌کردن هنگام وارد کردن ردیف‌ها را نمایندگی می‌کند و انواع زیر را پشتیبانی می‌کند:

  • SameAsAbove — اجازه کپی کردن فرمت‌ها مشابه ردیف بالایی.
  • SameAsBelow — allows copying formats same as below row.
  • Clear — اجازه می‌دهد که قالب‌بندی پاک شود.

از بین بردن ردیف‌ها از شیت‌های اکسل با استفاده از C#

شما می‌توانید با پیروی از مراحل زیر، به صورت برنامه‌نویسی ردیف‌ها را از شیت‌های اکسل حذف کنید:

  1. یک نمونه از کلاس Workbook با مسیر فایل ورودی ایجاد کنید.
  2. یک نمونه از کلاس Worksheet را ایجاد کنید.
  3. به کاربرگ از Worksheets مجموعه با استفاده از ایندکس آن دسترسی پیدا کنید.
  4. حذف ردیف‌ها با فراخوانی روش DeleteRows() و انتقال اندیس ردیف و تعداد ردیف‌های مورد نظر برای حذف.
  5. Call the Save() method with the output file path.

کد نمونه زیر نشان می‌دهد چگونه می‌توان ردیف‌ها را از یک شیت اکسل با استفاده از C# حذف کرد.

// ایجاد یک شیء Workbook
// بازکردن فایل اکسل از طریق جریان فایل
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین شیت در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// حذف 10 ردیف از کاربرگ شروع از ردیف 3
worksheet.Cells.DeleteRows(2, 10);

// ذخیره فایل اکسل اصلاح شده
workbook.Save(@"C:\Files\output.xlsx");

متد DeleteRow() کلاس Cells به شما امکان می‌دهد یک ردیف تنها را در ایندکس مشخص‌شده حذف کنید. به‌طور مشابه، متد DeleteRows() به شما اجازه می‌دهد که بیش از یک ردیف را حذف کنید. این متد یک ایندکس ردیف را از جایی که باید حذف ردیف‌ها آغاز شود و تعداد کل ردیف‌ها برای حذف به عنوان پارامتر ورودی دریافت می‌کند.

ستون‌ها را در برگه‌های اکسل با استفاده از C# وارد کنید

شما می‌توانید به طور برنامه‌نویسی ستون‌ها را در شیت‌های اکسل با دنبال کردن مراحل زیر وارد کنید:

  1. یک نمونه از کلاس Workbook با مسیر فایل ورودی ایجاد کنید.
  2. یک نمونه از کلاس Worksheet را ایجاد کنید.
  3. به کاربرگ از Worksheets مجموعه با استفاده از ایندکس آن دسترسی پیدا کنید.
  4. یک ستون اضافه کنید با فراخوانی متد InsertColumn() و اندیس ستونی که می‌خواهید یک ستون جدید در آن اضافه کنید را پاس دهید.
  5. Call the Save() method with the output file path.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان یک ستون را در یک شیت اکسل با استفاده از C# وارد کرد.

// ایجاد یک شیء Workbook
// باز کردن فایل اکسل از طریق جریان فایل
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین برگه در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// درج یک ستون به worksheet در موقعیت ۲
worksheet.Cells.InsertColumn(1);

// ذخیره فایل Excel ویرایش شده
workbook.Save(@"C:\Files\output.xlsx");
یک ستون واحد در صفحات اکسل با استفاده از C# وارد کنید

یک ستون تنها را در کاربرگ‌های اکسل با استفاده از C# وارد کنید.

به طور مشابه، می‌توانید چندین ستون را در یک شیت Excel با استفاده از نمونه کد ارائه شده در زیر وارد کنید:

// ایجاد یک شیء Workbook
// باز کردن فایل Excel از طریق جریان فایل
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین برگه در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// وارد کردن 5 ستون به worksheet از موقعیت 2 شروع می‌شود
worksheet.Cells.InsertColumns(2, 5);

// ذخیره فایل Excel تغییر یافته
workbook.Save(@"C:\Files\output.xlsx");
درج چندین ستون در کاربرگ‌های اکسل با استفاده از C#.

درج چندین ستون در کاربرگ‌های اکسل با استفاده از C# .

برای درج ستون‌ها در جدول‌های اکسل، کلاس Cells متد InsertColumns() را برای درج چندین ستون در یک جدول ارائه می‌دهد. این متد یک ایندکس ستون را به عنوان نقطه شروع برای درج ستون‌ها و تعداد کل ستون‌های جدید برای درج را به عنوان پارامترهای ورودی دریافت می‌کند. کلاس Cells همچنین متد InsertColumn() را برای درج یک ستون واحد در ایندکس مشخص شده ارائه می‌دهد.

حذف ستون ها از برگه های اکسل با استفاده از C#

شما می‌توانید به‌صورت برنامه‌نویسی ستون‌ها را از برگه‌های اکسل حذف کنید با دنبال کردن مراحل ذکر شده در زیر:

  1. یک نمونه از کلاس Workbook با مسیر فایل ورودی ایجاد کنید.
  2. یک نمونه از کلاس Worksheet را ایجاد کنید.
  3. به کاربرگ از Worksheets مجموعه با استفاده از ایندکس آن دسترسی پیدا کنید.
  4. یک ستون را با فراخوانی متد DeleteColumn() و عبور دادن ایندکس ستون برای حذف، حذف کنید.
  5. Call the Save() method with the output file path.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان یک ستون را از یک شیت Excel با استفاده از C# حذف کرد.

// ایجاد یک شیء Workbook
// Opening the Excel file through the file stream
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین برگه در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// حذف ستون سوم از ورق کار
worksheet.Cells.DeleteColumn(2);

// ذخیره فایل اکسل ویرایش شده
workbook.Save(@"C:\Files\output.xlsx");

به همین ترتیب، می‌توانید چندین ستون را از یک شیت اکسل با استفاده از مثال کد زیر حذف کنید.

// ایجاد یک شیء Workbook
// Opening the Excel file through the file stream
Workbook workbook = new Workbook(@"C:\Files\Book1.xlsx");

// دسترسی به اولین برگه در فایل اکسل
Worksheet worksheet = workbook.Worksheets[0];

// حذف ۵ ستون از worksheet از ستون سوم شروع می‌شود
worksheet.Cells.DeleteColumns(2, 5, false);

// ذخیره فایل اکسل تغییر یافته
workbook.Save(@"C:\Files\output.xlsx");

متد DeleteColumns() امکان حذف چندین ستون را به طور همزمان می‌دهد. این متد سه پارامتر می‌گیرد، یک ایندکس ستون که از آنجا شروع به حذف ستون‌ها می‌شود، تعداد کل ستون‌هایی که باید به عنوان پارامتر ورودی حذف شوند، و یک مقدار صحیح یا نادرست برای نشان دادن اینکه آیا باید ارجاعات در سایر ورق‌های کاری به‌روزرسانی شوند یا خیر. به همین ترتیب، متد DeleteColumn() کلاس Cells اجازه می‌دهد که یک ستون واحد در ایندکس مشخص شده حذف شود.

مجوز رایگان بگیرید

شما می‌توانید بدون محدودیت‌های ارزیابی از API استفاده کنید و با درخواست a free temporary license این کار را انجام دهید.

نتیجه گیری

در این مقاله، شما یاد گرفته‌اید که چگونه ردیف‌ها یا ستون‌ها را در فایل‌های Excel با استفاده از C# وارد کنید. شما همچنین یاد گرفته‌اید که چگونه ردیف‌ها و ستون‌ها را به‌طور برنامه‌نویسی از فایل‌های Excel حذف کنید. علاوه بر این، شما یاد گرفته‌اید که چگونه چندین ردیف یا ستون را در یک صفحه Excel وارد کنید. همچنین، شما یاد گرفته‌اید که چگونه چندین ردیف یا ستون را از فایل‌های Excel با استفاده از C# حذف کنید. می‌توانید بیشتر در مورد Aspose.Cells برای API .NET با استفاده از documentation یاد بگیرید. در صورت هرگونه ابهام، لطفاً با خیال راحت با ما در forum تماس بگیرید.

همچنین ببینید