نمونه سورس کد ابزاری مفید برای تبدیل فایل‌های MS Excel (xls. یا xlsx.) به فایل‌های نوع Json در سی شارپ

نمونه سورس کد ابزاری مفید برای تبدیل فایل‌های MS Excel (xls و xlsx) به فایل‌های نوع JSON در سی‌شارپ

در دنیای برنامه‌نویسی، یکی از چالش‌های رایج، تبدیل داده‌ها از فرمت‌های مختلف به یکدیگر است، مخصوصاً زمانی که داده‌ها در فایل‌های Excel ذخیره شده‌اند و نیاز است که به شکل JSON تبدیل شوند. این فرآیند، به ویژه در توسعه برنامه‌های مبتنی بر وب، تجزیه و تحلیل داده‌های بزرگ، یا ارتباط با APIهای مدرن، کاربرد فراوان دارد. در این مقاله، قصد داریم یک نمونه سورس کد کامل و جامع در زبان برنامه‌نویسی سی‌شارپ (C#) ارائه دهیم که به وسیله آن، می‌توانید فایل‌های Excel (با پسوندهای xls و xlsx) را به راحتی به قالب JSON تبدیل کنید.
مزایای استفاده از این ابزار
قبل از شروع، بیاید نگاهی بیندازیم به مزایای این ابزار. نخست، این ابزار به صورت کامل و قابل تنظیم است، یعنی شما می‌توانید بر اساس نیاز خود، ساختار داده‌ها را تغییر دهید. دوم، از آنجا که این ابزار بر پایه کتابخانه‌های معتبر و پرکاربرد کار می‌کند، اطمینان حاصل می‌شود که عملیات به صورت سریع و بدون خطا انجام می‌شود. سوم، قابلیت پشتیبانی از هر دو فرمت فایل Excel، یعنی xls و xlsx، باعث شده تا این ابزار، بسیار انعطاف‌پذیر باشد و در پروژه‌های مختلف قابل استفاده است.
کتابخانه‌های مورد نیاز
برای شروع، باید چند کتابخانه مهم را نصب کنید. یکی از پرکاربردترین کتابخانه‌ها برای خواندن فایل‌های Excel در سی‌شارپ، کتابخانه EPPlus است. این کتابخانه به صورت رایگان و متن‌باز است و امکان خواندن و نوشتن فایل‌های Excel بدون نیاز به نصب Microsoft Office را فراهم می‌کند. همچنین، برای تبدیل داده‌ها به JSON، کتابخانه Newtonsoft.Json (یا Json.NET) انتخاب مناسبی است که قابلیت‌های فراوانی در سریال‌سازی و دی‌سریال‌سازی داده‌ها دارد.
برای نصب این کتابخانه‌ها، می‌توانید از NuGet Package Manager استفاده کنید. کافی است در ترمینال Visual Studio فرمان‌های زیر را اجرا کنید:

Install-Package EPPlus  
Install-Package Newtonsoft.Json  

ساختار کلی برنامه
برنامه ما شامل چند بخش اصلی است:
1. خواندن فایل Excel و استخراج داده‌ها
2. ساخت ساختار داده مناسب برای JSON
3. تبدیل داده‌ها به فرمت JSON

1. ذخیره‌سازی یا نمایش خروجی

در ادامه، هر بخش به تفصیل شرح داده می‌شود.

1. خواندن فایل Excel و استخراج داده‌ها

در این قسمت، فایل Excel را باز می‌کنیم و داده‌های آن را در ساختارهای مناسب (مثل لیست‌ها یا آرایه‌ها) می‌خوانیم. برای این کار، ابتدا یک شیء ExcelPackage می‌سازیم و سپس برگه‌های مورد نظر را بررسی می‌کنیم.

csharp  
using OfficeOpenXml;
using Newtonsoft.Json;
using System.Collections.Generic;
using System.IO;
public class ExcelToJsonConverter  
{
public static string ConvertExcelToJson(string filePath)
{
var dataList = new List>();
FileInfo existingFile = new FileInfo(filePath);
using (ExcelPackage package = new ExcelPackage(existingFile))
{
// فرض بر این است که ما می‌خواهیم اولین برگه را پردازش کنیم  
ExcelWorksheet worksheet = package.Workbook.Worksheets[0];
int totalRows = worksheet.Dimension.End.Row;
int totalCols = worksheet.Dimension.End.Column;
// خواندن سرستون‌ها  
var headers = new List();
for (int col = 1; col <= totalCols; c...  ← ادامه مطلب در magicfile.ir