مارکت

سورس کد خواندن فایل اکسل با سی‌شارپ (C#) و ویژوال بیسیک دات‌نت (VB.NET): راهنمای جامع و کامل

در دنیای برنامه‌نویسی، یکی از نیازهای رایج و پرکاربرد، خواندن و دریافت داده‌ها از فایل‌های اکسل است. این فرآیند در پروژه‌های مختلف، از جمله سیستم‌های اتوماسیون، برنامه‌های مدیریتی، داده‌کاوی و بسیاری موارد دیگر، بسیار ضروری و حیاتی است. بنابراین، در این مقاله قصد داریم به صورت کامل و جامع، نحوه خواندن فایل‌های اکسل با استفاده از زبان‌های برنامه‌نویسی سی‌شارپ (C#) و ویژوال بیسیک دات‌نت (VB.NET) را شرح دهیم، و در کنار آن، نکات مهم، نمونه کدهای عملی، و روش‌های مختلف را بیان کنیم.
مقدمه‌ای بر فایل‌های اکسل و نیازهای خواندن آن‌ها
فایل‌های اکسل (Excel Files) با پسوندهای XLS و XLSX، یکی از محبوب‌ترین و رایج‌ترین ابزارهای ذخیره‌سازی داده‌ها هستند. این فایل‌ها ساختاری جدولی دارند، که در آن داده‌ها در سطرها و ستون‌ها قرار گرفته‌اند. کاربران معمولاً نیاز دارند تا این داده‌ها را در برنامه‌های خود بخوانند، پردازش کنند، و یا تحلیل‌های لازم را انجام دهند.
در حالت کلی، سه روش اصلی برای خواندن فایل‌های اکسل در زبان‌های برنامه‌نویسی وجود دارد:
1. استفاده از کتابخانه‌های COM و Microsoft Office Interop: این روش، نیازمند نصب نرم‌افزار اکسل بر روی سیستم است و معمولا برای برنامه‌های دسکتاپ مناسب است.
2. استفاده از کتابخانه‌های شخص ثالث (Third-party Libraries): مانند EPPlus، NPOI، ClosedXML و سایر ابزارهای متن‌باز و تجاری.
3. خواندن فایل‌های اکسل به صورت فایل‌های ZIP و XML (برای فایل‌های XLSX): این روش نیازمند تحلیل ساختار فایل است، ولی در عین حال، انعطاف‌پذیری بسیار بالا دارد.
در این مقاله، بیشتر تمرکز بر روش‌های رایج و قابل استفاده در پروژه‌های سی‌شارپ و VB.NET است، و در این راستا، از کتابخانه‌های محبوب و قدرتمند، مانند EPPlus و NPOI، بهره خواهیم برد.
---

خواندن فایل اکسل با سی‌شارپ (C#)

در برنامه‌نویسی با زبان سی‌شارپ، برای خواندن فایل‌های اکسل، چندین راه وجود دارد. یکی از رایج‌ترین و قدرتمندترین روش‌ها، استفاده از کتابخانه EPPlus است. این کتابخانه، امکان کار با فایل‌های XLSX بدون نیاز به نصب Microsoft Office را فراهم می‌کند و بسیار کاربرپسند است.

نصب کتابخانه EPPlus

برای استفاده از EPPlus، ابتدا باید آن را از طریق NuGet Package Manager نصب کنید:

bash  

Install-Package EPPlus  

یا در محیط Visual Studio، به قسمت NuGet Package Manager بروید و جستجو کنید: *EPPlus*، سپس نصب کنید.

نمونه کد خواندن فایل اکسل در سی‌شارپ

در ادامه، نمونه کدی ارائه می‌دهیم که یک فایل اکسل را باز می‌کند، و داده‌های آن را در قالب جدول می‌خواند:

csharp  

using OfficeOpenXml;

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

{

    FileInfo fileInfo = new FileInfo(filePath);

    using (ExcelPackage package = new ExcelPackage(fileInfo))

    {

        ExcelWorkbook workbook = package.Workbook;

        if (workbook != null && workbook.Worksheets.Count > 0)

        {

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

            int rowCount = worksheet.Dimension.End.Row;

            int colCount = worksheet.Dimension.End.Column;
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();

            }

        }

    }

}

در این نمونه، ابتدا فایل اکسل را باز می‌کنیم، سپس به اولین صفحه آن مراجعه می‌کنیم، و داده‌های هر سلول را در حلقه‌های تو در تو می‌خوانیم. این روش بسیار ساده و کارآمد است و برای پروژه‌های مختلف مناسب است.
---

خواندن فایل اکسل با ویژوال بیسیک دات‌نت (VB.NET)

در زبان VB.NET، همانند سی‌شارپ، می‌توان از کتابخانه EPPlus بهره برد. روند نصب و استفاده مشابه است، و در ادامه، نمونه کد مربوطه را مشاهده می‌کنید:

vb.net  

Imports OfficeOpenXml  

Imports System.IO
Public Sub ReadExcelFileVB(filePath As String)

    Dim fileInfo As New FileInfo(filePath)

    Using package As New ExcelPackage(fileInfo)

        Dim workbook As ExcelWorkbook = package.Workbook  

        If workbook IsNot Nothing AndAlso workbook.Worksheets.Count > 0 Then  

            Dim worksheet As ExcelWorksheet = workbook.Worksheets(1) ' اولین صفحه  

            Dim rowCount As Integer = worksheet.Dimension.End.Row  

            Dim colCount As Integer = worksheet.Dimension.End.Column
For row As Integer = 1 To rowCount  

                For col As Integer = 1 To colCount  

                    Dim cellValue As String = worksheet.Cells(row, col).Text  

                    Console.Write($"{cellValue}" & vbTab)

                Next  

                Console.WriteLine()

            Next  

        End If  

    End Using  

End Sub  

این نمونه نشان می‌دهد که چگونه می‌توان در VB.NET، داده‌های اکسل را خواند و آن‌ها را در کنسول نمایش داد. توجه کنید که ساختار کد بسیار مشابه نمونه سی‌شارپ است، اما با سینتکس و قواعد زبان VB.NET.
---

نکات مهم و موارد کاربردی

- مدیریت خطا و استثناها: هنگام کار با فایل‌های اکسل، حتما از بلوک‌های try-catch استفاده کنید تا در صورت بروز خطا، برنامه به درستی مدیریت شود.
- مشخص کردن صفحه موردنظر: اگر فایل اکسل صفحات متفاوتی دارد، می‌توانید با نام یا شماره صفحه موردنظر را انتخاب کنید.
- خواندن داده‌های خاص: برای نمونه، اگر خواستید فقط ستون خاصی را بخوانید، باید بر اساس شماره ستون یا نام ستون، حلقه‌ها را تنظیم کنید.
- کار با فایل‌های بزرگ: در صورت فایل‌های بزرگ، بهتر است از روش‌های بهینه‌تری برای خواندن داده‌ها استفاده کنید، مانند خواندن هر بار بخش کوچکی از فایل، یا پردازش به صورت “streaming”.
---

کتابخانه‌های دیگر و روش‌های جایگزین

علاوه بر EPPlus، کتابخانه NPOI نیز یکی دیگر از گزینه‌های قدرتمند است که امکان خواندن و نوشتن در فایل‌های XLS و XLSX را فراهم می‌کند. این کتابخانه، متن‌باز و رایگان است و قابلیت‌های متنوعی دارد.
برای مثال، نمونه کد NPOI برای خواندن فایل اکسل در سی‌شارپ، به شکل زیر است:

csharp  

using NPOI.SS.UserModel;

using NPOI.XSSF.UserModel;

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

{

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

    {

        IWorkbook workbook = new XSSFWorkbook(fs);

        ISheet sheet = workbook.GetSheetAt(0);

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

        {

            IRow row = sheet.GetRow(i);

            if (row != null)

            {

                for (int j = row.FirstCellNum; j < row.LastCellNum; j++)

                {

                    ICell cell = row.GetCell(j);

                    string cellText = cell?.ToString() ?? "";

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

                }

                Console.WriteLine();

            }

        }

    }

}

---

جمع‌بندی و نتیجه‌گیری

در انتهای این مقاله، باید گفت که خواندن فایل‌های اکسل در برنامه‌نویسی، نیازمند انتخاب روش مناسب و ابزارهای قدرتمند است. در سی‌شارپ و VB.NET، استفاده از کتابخانه‌های EPPlus و NPOI، بیشترین انعطاف‌پذیری و کارایی را فراهم می‌کنند. این کتابخانه‌ها، امکان خواندن داده‌ها، پردازش و مدیریت فایل‌های اکسل را به صورت ساده و حرفه‌ای فراهم می‌سازند.
همچنین، توجه به نکات مهم مانند مدیریت استثنا، انتخاب صفحه موردنظر، و کار با فایل‌های بزرگ، کمک می‌کند تا پروژه‌های شما پایدار و بهینه باشند. در نهایت، بهره‌گیری از این ابزارها و روش‌ها، مهارت شما در توسعه برنامه‌های کاربردی را به سطح بالاتری می‌برد و امکان پیاده‌سازی سیستم‌های قدرتمند و انعطاف‌پذیر را فراهم می‌آورد.
امیدوارم این راهنمای جامع، پاسخگوی نیازهای شما باشد و بتوانید با اطمینان کامل، پروژه‌های خود را در زمینه خواندن فایل‌های اکسل پیاده‌سازی کنید.