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


در دنیای امروز، مدیریت داده‌ها اهمیت فوق‌العاده‌ای دارد، و یکی از رایج‌ترین فایل‌های مورد استفاده، فایل‌های Excel هستند که در قالب‌های xls و xlsx ظاهر می‌شوند. اما، در بسیاری موارد، نیاز است تا این داده‌ها به فرمت JSON تبدیل شوند، چون JSON ساختاری قابل فهم‌تر، سبک‌تر و مناسب برای برنامه‌نویسی و انتقال داده‌ها است. به همین دلیل، توسعه یک ابزار کاربردی در زبان برنامه‌نویسی سی‌شارپ برای تبدیل فایل‌های Excel به JSON، می‌تواند بسیار مفید و کارآمد باشد.
در این مقاله، به طور کامل و جامع، نمونه سورس کد و فرآیند توسعه چنین ابزاری را شرح می‌دهیم. هدف این است که بتوانید با درک کامل، بتوانید ابزار مورد نیاز خود را بنویسید یا از آن بهره‌برداری کنید، و درک کنید که چگونه داده‌های Excel را به صورت اتوماتیک و موثر به JSON تبدیل کنید.

اهمیت تبدیل فایل‌های Excel به JSON




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

ابزارهای مورد نیاز و کتابخانه‌های سی‌شارپ




برای پیاده‌سازی این پروژه، نیاز به چند کتابخانه و ابزار داریم. مهم‌ترین آن‌ها، کتابخانه `Microsoft.Office.Interop.Excel` است که امکان خواندن فایل‌های Excel را فراهم می‌کند. در کنار آن، می‌توان از کتابخانه `Newtonsoft.Json` یا `System.Text.Json` برای تبدیل داده‌ها به JSON بهره برد.
نکته مهم این است که، برای کار با فایل‌های Excel، باید حتماً Office نصب باشد، مگر اینکه از کتابخانه‌های جایگزین مانند EPPlus یا ClosedXML استفاده کنید، که بدون نیاز به نصب Office، فایل‌ها را می‌خوانند و می‌نویسند.
در این مقاله، از کتابخانه EPPlus استفاده می‌کنیم، چون سبک‌تر، سریع‌تر و بدون نیاز به نصب Office است. همچنین، برای تبدیل داده‌ها به JSON، از Newtonsoft.Json بهره می‌بریم، که یکی از قدرتمندترین و پرکاربردترین کتابخانه‌های JSON در سی‌شارپ است.

فرآیند توسعه ابزار




در ادامه، فرآیند کلی توسعه ابزار را به چند بخش مجزا تقسیم می‌کنیم:
  1. بارگذاری فایل Excel

  1. خواندن داده‌ها و ساختاردهی آن‌ها

  1. تبدیل داده‌ها به ساختارهای قابل تبدیل به JSON

  1. تبدیل و ذخیره‌سازی در قالب JSON
    در هر یک از این بخش‌ها، نکات مهم و کدهای نمونه را شرح می‌دهیم.
    ---

    بارگذاری فایل Excel




در ابتدا، باید فایل Excel مورد نظر را باز کنیم. فرض کنید فایل در مسیر مشخصی قرار دارد. از کتابخانه EPPlus برای این کار بهره می‌گیریم:
csharp  


using OfficeOpenXml;


using System.IO;
public ExcelPackage LoadExcelFile(string filePath)


{


    FileInfo fileInfo = new FileInfo(filePath);


    ExcelPackage package = new ExcelPackage(fileInfo);


    return package;


}

در این مرحله، فایل را باز می‌کنیم و آماده خواندن داده‌ها می‌شویم.
---

خواندن داده‌ها و ساختاردهی آن‌ها




اکنون، باید برگه‌های موجود در فایل را بررسی کنیم و داده‌ها را استخراج کنیم. معمولا، داده‌های Excel در قالب جدول قرار دارند، پس باید سطرها و ستون‌ها را به صورت حلقه‌ای بخوانیم.
یک نمونه کد برای خواندن داده‌های برگه:
csharp  


public ...  ← ادامه مطلب در magicfile.ir