تبسيط إنشاء وتخصيص جداول البيانات Excel باستخدام واجهة برمجة التطبيقات .NET

البدء في استخدام FileFormat.Cells لـ .NET

الطريقة الموصى بها لتثبيت FileFormat.Cells لـ .NET هي استخدام NuGet. الرجاء استخدام الأمر التالي للتثبيت السلس.

NuGet\Install-Package FileFormat.Cells 

إنشاء مصنف / جدول بيانات Excel فارغ برمجيًا

يوضح مقتطف التعليمات البرمجية التالي كيفية إنشاء وحفظ جدول بيانات Microsoft Excel جديد باستخدام لغة C# مع مكتبة FileFormat.Cells.

• يبدأ الكود باستيراد مكتبة FileFormat.Cells الضرورية، مما يوفر إمكانية الوصول إلى الوظائف اللازمة لمعالجة جداول بيانات Excel.
• ضمن مساحة الاسم النموذجية، يتم تعريف فئة البرنامج.
• يعمل الأسلوب Main كنقطة دخول للبرنامج، ويقبل وسيطات سطر الأوامر إن وجدت (string[] args).
• تتم تهيئة مثيل لفئة المصنف باستخدام Workbook Workbook = new Workbook();.
• يتم استدعاء الأسلوب Save في نسخة المصنف لحفظ جدول بيانات Excel. يتم حفظ الملف بالاسم "Spreadsheet.xlsx" في الدليل الجذر `("/") للقرص.

انسخ مقتطف الشفرة أدناه والصقه في ملفك الرئيسي وقم بتنفيذ البرنامج.

 
using FileFormat.Cells;

namespace Example
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize an instance of the Workbook class.
            Workbook workbook = new Workbook();

            // Call the Save method to save the MS Excel Spreadsheet/Workbook onto the disk.
            workbook.Save("/Spreadsheet.xlsx");
        }

    }
}

الحصول على قيم الخلايا من جدول بيانات/مصنف Excel برمجيًا

يوضح التعليمة البرمجية التالية كيفية فتح جدول بيانات Microsoft Excel موجود باستخدام لغة C# واسترداد القيمة من خلية معينة. للوصول إلى جدول البيانات والتفاعل معه، اتبع الخطوات التالية:

• قم بإنشاء مثيل لفئة المصنف عن طريق تحديد المسار إلى جدول البيانات الموجود لديك.
• استخرج ورقة العمل من المصنف.
• قم بتعيين كائن الخلية إلى متغير.
• استخدم طريقة GetValue() لاستخراج القيمة من الخلية المحددة.

انسخ مقتطف الشفرة أدناه والصقه في ملفك الرئيسي وقم بتنفيذ البرنامج.

 

using (Workbook wb = new Workbook(filePath)) // Load existing spreadsheet/workbook file.
{
    Worksheet firstSheet = wb.Worksheets[0]; // Load first worksheet within workbook.
    Cell cellA1 = firstSheet.Cells["A1"]; // Get A1 cell object within cellA1 variable.
    Console.WriteLine(cellA1.GetDataType()); // Output cellA1 data type.
    string value = cellA1.GetValue(); // Get value within cell A1.
    Console.WriteLine(value); // Output the value stored in cell A1
}

دمج الخلايا في ورقة عمل Excel برمجياً

يوضح التعليمة البرمجية المتوفرة كيفية دمج الخلايا برمجيًا في جدول بيانات Microsoft Excel باستخدام لغة C#. فيما يلي تفاصيل الخطوات:

• قم بتهيئة مثيل جديد لفئة المصنف.
• قم بالوصول إلى ورقة العمل الأولى داخل المصنف.
• استخدم أسلوب MergeCells لدمج الخلايا من A1 إلى C1.
• قم بتعيين قيمة للخلية العلوية اليسرى للمنطقة المدمجة.
• احفظ المصنف المعدل في مسار ملف محدد.

لدمج هذه الوظيفة في تطبيق C# الخاص بك، اتبع الخطوات التالية:

• أدخل مقتطف الشفرة في ملفك الرئيسي.
• نفذ البرنامج لدمج الخلايا وتعيين القيم وفقًا لذلك.

يعمل هذا الأسلوب على تبسيط عملية دمج الخلايا ومعالجة بيانات الخلية داخل جداول بيانات Excel برمجيًا

انسخ مقتطف الشفرة أدناه والصقه في ملفك الرئيسي وقم بتنفيذ البرنامج.

 

using (var workbook = new Workbook())
{
    var firstSheet = workbook.Worksheets[0];
    firstSheet.MergeCells("A1", "C1"); // Merge cells from A1 to C1

    // Add value to the top-left cell of the merged area
    var topLeftCell = firstSheet.Cells["A1"];
    topLeftCell.PutValue("This is a merged cell");

    workbook.Save(filePath);
}