تگ های موضوع سورس کد خواندن فایل اکسل

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

در دنیای توسعه نرم‌افزار، یکی از نیازهای متداول و پرکاربرد، خواندن داده‌ها از فایل‌های اکسل است. فایل‌های اکسل، به‌خاطر ساختار ساده و در عین حال قدرتمند خود، برای ذخیره‌سازی، تحلیل و پردازش داده‌ها بسیار محبوب هستند. بنابراین، توسعه‌دهندگان و برنامه‌نویسان، اغلب نیاز دارند تا بتوانند این فایل‌ها را در برنامه‌های خود بارگذاری و پردازش کنند. در زبان C#، این کار می‌تواند با استفاده از چندین روش انجام شود، که یکی از رایج‌ترین و موثرترین آن‌ها، بهره‌گیری از کتابخانه‌های خارجی مانند EPPlus، NPOI و ClosedXML است. در ادامه، به صورت جامع و مفصل، به توضیح نحوه‌ی خواندن فایل‌های اکسل در C# می‌پردازیم، با تمرکز بر استفاده از کتابخانه‌های محبوب و ارائه نمونه‌های کد کاربردی.
چرا از کتابخانه‌های خارجی استفاده کنیم؟
در اصل، زبان C# به صورت پیش‌فرض امکانات محدودی برای کار با فایل‌های اکسل ارائه می‌دهد. به همین دلیل، استفاده از کتابخانه‌های خارجی، کار را بسیار ساده‌تر، سریع‌تر و قابل اطمینان‌تر می‌کند. این کتابخانه‌ها، امکانات متعددی برای خواندن، نوشتن، و ویرایش فایل‌های اکسل در قالب‌های مختلف (مانند XLS و XLSX) فراهم می‌کنند، بدون نیاز به نصب نرم‌افزار اکسل بر روی سیستم.
کتابخانه‌های محبوب برای خواندن فایل اکسل در C#
1. EPPlus: یکی از قدرتمندترین و محبوب‌ترین کتابخانه‌ها برای کار با فایل‌های اکسل است که بر پایه‌ی Open Office XML format (.xlsx) ساخته شده است. این کتابخانه، امکانات فراوانی برای خواندن و نوشتن داده‌ها، قالب‌بندی، و حتی ایجاد فایل‌های اکسل جدید دارد.
2. NPOI: نسخه‌ی Java-based Apache POI است که برای زبان C# port شده است. این کتابخانه از فرمت‌های قدیمی‌تر XLS و همچنین XLSX پشتیبانی می‌کند، و برای پروژه‌هایی که نیاز به کار با فایل‌های قدیمی‌تر دارند، بسیار مناسب است.
3. ClosedXML: یک کتابخانه ساده و کاربرپسند است که بر پایه EPPlus ساخته شده، و به توسعه‌دهندگان اجازه می‌دهد تا به راحتی فایل‌های اکسل را بخوانند و ویرایش کنند.
در ادامه، به بررسی نحوه‌ی استفاده از هرکدام از این کتابخانه‌ها می‌پردازیم.
نحوه نصب کتابخانه‌ها
برای استفاده از این کتابخانه‌ها در پروژه‌ی C#، باید آن‌ها را از طریق NuGet Package Manager نصب کنید:
- EPPlus: در Visual Studio، به Tools → NuGet Package Manager → Manage NuGet Packages بروید، و جستجو کنید “EPPlus”. سپس نصب کنید.
- NPOI: در همان مسیر، جستجو کنید “NPOI” و نصب آن.
- ClosedXML: به همین صورت، جستجو و نصب “ClosedXML”.
در ادامه، نمونه‌های کد برای هرکدام ارائه شده است.
خواندن فایل اکسل با EPPlus
فرض کنید فایل اکسل دارید، نام آن “Sample.xlsx”، و می‌خواهید داده‌های آن را خوانده و نمایش دهید. کد زیر، این کار را انجام می‌دهد:

csharp  

using OfficeOpenXml;

using System.IO;
public void ReadExcelWithEPPlus(string filePath)

{

    // حتماً قبل از استفاده، اجازه دهید EPPlus لایسنس را تنظیم کند  

    ExcelPackage.LicenseContext = LicenseContext.NonCommercial;
FileInfo existingFile = new FileInfo(filePath);
using (ExcelPackage package = new ExcelPackage(existingFile))

    {

        ExcelWorksheet worksheet = package.Workbook.Worksheets[0]; // اولیین صفحه  

        int rowCount = worksheet.Dimension.Rows;

        int colCount = worksheet.Dimension.Columns;
for (int row = 1; row <= rowCount; row++)

        {

            for (int col = 1; col <= colCount; col++)

            {

                var cellValue = worksheet.Cells[row, col].Text;

                Console.Write($"{cellValue}\t");

            }

            Console.WriteLine();

        }

    }

}

در این کد، ابتدا فایل اکسل را باز می‌کنیم، سپس به صفحه‌ی اول آن دسترسی پیدا می‌کنیم، و داده‌های هر سلول را در حلقه‌های تو در تو می‌خوانیم و نمایش می‌دهیم. توجه کنید که EPPlus نیازمند تنظیم لایسنس است، که در نسخه‌های جدید، این نکته مهم است.
خواندن فایل اکسل با NPOI
در این روش، از NPOI استفاده می‌کنیم، که قابلیت خواندن فایل‌های XLS و XLSX را دارد:

csharp  

using NPOI.XSSF.UserModel;

using System.IO;
public void ReadExcelWithNPOI(string filePath)

{

    using (FileStream stream = new FileStream(filePath, FileMode.Open, FileAccess.Read))

    {

        XSSFWorkbook workbook = new XSSFWorkbook(stream);

        var sheet = workbook.GetSheetAt(0); // صفحه اول  

        for (int rowIdx = sheet.FirstRowNum; rowIdx <= sheet.LastRowNum; rowIdx++)

        {

            var row = sheet.GetRow(rowIdx);

            if (row == null) continue;
for (int colIdx = 0; colIdx < row.LastCellNum; colIdx++)

            {

                var cell = row.GetCell(colIdx);

                if (cell != null)

                {

                    Console.Write($"{cell.ToString()}\t");

                }

            }

            Console.WriteLine();

        }

    }

}

این نمونه، ساده و قابل فهم است، و برای فایل‌های قدیمی‌تر و جدید، قابل استفاده است.
خواندن فایل اکسل با ClosedXML
روش دیگر، استفاده از ClosedXML است، که کار با اکسل را بسیار ساده‌تر می‌کند:

csharp  

using ClosedXML.Excel;
public void ReadExcelWithClosedXML(string filePath)

{

    var workbook = new XLWorkbook(filePath);

    var worksheet = workbook.Worksheets.Worksheet(1); // صفحه اول
var range = worksheet.RangeUsed();
foreach (var row in range.Rows())

    {

        foreach (var cell in row.Cells())

        {

            Console.Write($"{cell.Value}\t");

        }

        Console.WriteLine();

    }

}

این نمونه، به صورت بسیار ساده و کاربر پسند، داده‌های فایل اکسل را می‌خواند و نمایش می‌دهد. همچنین، امکاناتی برای ویرایش و قالب‌بندی دارد.
نکات مهم و نکات پیشرفته
1. مدیریت استثناها: هنگام خواندن فایل‌های اکسل، بهتر است کدهای خود را در بلوک‌های try-catch قرار دهید تا در صورت وجود خطا، برنامه به درستی مدیریت شود.
2. پشتیبانی از فایل‌های بزرگ: فایل‌های اکسل بزرگ، نیازمند مدیریت حافظه و بهینه‌سازی است. در این موارد، بهتر است از روش‌های Lazy Loading یا بخش‌بندی داده‌ها استفاده کنید.
3. کار با داده‌های متنوع: توجه کنید که داده‌ها می‌توانند انواع مختلفی داشته باشند: متن، عدد، تاریخ، یا مقادیر خالی. باید این موارد را در کدهای خود مدیریت کنید.
4. خواندن و نوشتن در کنار هم: این کار، به توسعه‌دهندگان اجازه می‌دهد تا همزمان داده‌ها را از فایل خوانده و ویرایش کنند، و سپس فایل جدیدی تولید کنند.
5. پشتیبانی از فرمت‌های قدیمی‌تر: اگر نیاز دارید با فایل‌های XLS کار کنید، NPOI گزینه‌ی مناسبی است؛ اما EPPlus تنها از فایل‌های XLSX پشتیبانی می‌کند.
نتیجه‌گیری
در مجموع، خواندن فایل‌های اکسل در زبان C#، با توجه به نیازهای پروژه، می‌تواند با استفاده از کتابخانه‌های قدرتمند و متنوع انجام شود. هرکدام از این کتابخانه‌ها، مزایا و معایب خاص خود را دارند، و انتخاب صحیح، بستگی به نوع فایل‌های مورد استفاده، حجم داده‌ها، و امکانات مورد نیاز دارد. در پروژه‌های کوچک و متوسط، ClosedXML و EPPlus گزینه‌های عالی هستند، در حالی که NPOI، برای فایل‌های قدیمی‌تر و نیازهای پیشرفته‌تر، بهتر عمل می‌کند. بنابراین، اهمیت دارد که قبل از شروع توسعه، نیازهای پروژه‌ی خود را به دقت ارزیابی کنید، و سپس بهترین ابزار را بر اساس آن انتخاب کنید. با رعایت نکات امنیتی، مدیریت استثناها، و بهینه‌سازی حافظه، می‌توانید پروژه‌ای قدرتمند و کارآمد در کار با فایل‌های اکسل ایجاد کنید.