NPOI هي واجهة برمجة تطبيقات .NET مفتوحة المصدر لتطوير التطبيقات للعمل مع جداول البيانات. إنه متاح مجانًا ويمكنك استخدامه في مشاريع .NET الخاصة بك. NPOI بسيط وسهل الاستخدام ، ويمكن إعداده بسهولة لبدء العمل مع جداول بيانات Excel. في هذه المقالة ، سنستكشف العمل مع NPOI API لإنشاء ملفات Excel XLSX وقراءتها وحفظها ، على الرغم من أنه يمكن أن تعمل مع تنسيق ملف XLS بنفس الطريقة. تحتوي هذه المقالة على تفاصيل حول تثبيت API NPOI ، وإعداد بيئة التطوير ، والعمل مع جداول البيانات باستخدام NPOI.

  1. دليل التثبيت لـ NPOI API: الخطوة الأولى لاستخدام NPOI API هي تثبيت الحزمة. يمكنك تثبيت NPOI عن طريق تنزيل الحزمة من الموقع الرسمي أو استخدام Nuget Package Manager في Visual Studio. بمجرد تثبيت الحزمة ، يمكنك البدء في استخدامها في مشروعك. انظر هذا دليل تثبيت NPOI كمرجع.
  2. إعداد بيئة التطوير: من أجل استخدام NPOI API ، يجب أن يكون لديك بيئة التطوير جاهزة للعمل معها. يمكنك تثبيت Visual Studio على جهازك لهذا الغرض.
  3. إنشاء جدول بيانات جديد باستخدام NPOI API: الآن بعد أن تم إعداد بيئتك ، يمكنك البدء في العمل مع واجهة برمجة التطبيقات في مشروعك من خلال تضمين إشارة إلى DLL.

العمل مع جداول البيانات

حسنًا ، الآن بعد أن قمت بإعداد NPOI ، دعنا نبدأ باستخدام NPOI API للعمل مع ملفات XLSX. على وجه التحديد ، سنكون:

  • إنشاء جدول بيانات جديد باستخدام NPOI في C#
  • قراءة البيانات من ملف XLSX مع NPOI
  • حفظ جدول بيانات Excel مثل XLSX باستخدام NPOI

قم بإنشاء جدول بيانات جديد باستخدام NPOI في C#

يوضح مقتطف الكود التالي كيفية إنشاء جدول بيانات جديد مع ورقة عمل واحدة:

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// create a new workbook
IWorkbook wb = new XSSFWorkbook();

// create a new worksheet
ISheet ws = wb.CreateSheet("Sheet1");

// create a new row
IRow row = ws.CreateRow(0);

// create a new cell and set its value
ICell cell = row.CreateCell(0);
cell.SetCellValue("Hello World!");

// save the workbook
using (var fileStream = new FileStream("myWorkbook.xlsx", FileMode.Create, FileAccess.Write))
{
    wb.Write(fileStream);
}

قراءة البيانات من جداول البيانات باستخدام NPOI API

واحدة من المهام الأكثر شيوعًا عند العمل مع جداول البيانات هي قراءة البيانات منها. يوفر NPOI API عدة طرق لقراءة البيانات من جداول البيانات. يوضح مقتطف الكود التالي كيفية قراءة البيانات من خلية في جدول بيانات:

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// load an existing workbook
IWorkbook wb = new XSSFWorkbook("myWorkbook.xlsx");

// get the first worksheet
ISheet ws = wb.GetSheetAt(0);

// get the first row
IRow row = ws.GetRow(0);

// get the first cell
ICell cell = row.GetCell(0);

// get the cell value
string cellValue = cell.StringCellValue;

كتابة البيانات إلى جداول البيانات باستخدام NPOI API

مهمة مشتركة أخرى عند العمل مع جداول البيانات هي كتابة البيانات إليهم. يوفر NPOI API عدة طرق لكتابة البيانات إلى جداول البيانات. يوضح مقتطف الكود التالي كيفية كتابة البيانات إلى خلية في جدول بيانات:

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// load an existing workbook
IWorkbook wb = new XSSFWorkbook("myWorkbook.xlsx");

// get the first worksheet
ISheet ws = wb.GetSheetAt(0);

// get the first row
IRow row = ws.GetRow(0);

// get the first cell
ICell cell = row.CreateCell(1);

// set the cell value
cell.SetCellValue("World!");

// save the workbook
using (var fileStream = new FileStream("myWorkbook.xlsx", FileMode.Create, FileAccess.Write))
{
    wb.Write(fileStream);
}

في المثال أعلاه ، نقوم بتحميل مصنف حالي واسترجاع ورقة العمل الأولى. ثم نقوم باسترداد الصف الأول وننشئ خلية جديدة في فهرس العمود 1. ثم قمنا بتعيين قيمة الخلية وحفظ المصنف.

تحديث جداول البيانات الحالية باستخدام NPOI API

يوفر NPOI API أيضًا عدة طرق لتحديث جداول البيانات الحالية. يوضح مقتطف الكود التالي كيفية تحديث قيمة الخلية في جدول بيانات.

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// load an existing workbook
IWorkbook wb = new XSSFWorkbook("myWorkbook.xlsx");

// get the first worksheet
ISheet ws = wb.GetSheetAt(0);

// get the first row
IRow row = ws.GetRow(0);

// get the first cell
ICell cell = row.GetCell(0);

// set the cell value
cell.SetCellValue("Hello NPOI!");

// save the workbook
using (var fileStream = new FileStream("myWorkbook.xlsx", FileMode.Create, FileAccess.Write))
{
    wb.Write(fileStream);
}

في المثال أعلاه ، نقوم بتحميل مصنف حالي واسترجاع ورقة العمل الأولى. ثم نقوم باسترداد الصف الأول والخلية الأولى وتحديث قيمة الخلية. أخيرًا ، نقوم بإنقاذ المصنف.

المزيد من أمثلة NPOI للعمل مع جداول البيانات