1. محصولات
  2.   Aspose.Cells
  3.   Aspose.Cells FOSS for .NET

Aspose.Cells FOSS for .NET

ایجاد، ویرایش و ذخیرهٔ کتاب‌کارهای Excel .xlsx از .NET — رایگان و متن‌باز، بدون وابستگی به Microsoft Office.

کتابخانه .NET منبع باز برای جداول برقی اکسل

Aspose.Cells FOSS برای .NET یک کتابخانه منبع باز رایگان با مجوز MIT است که برای کار با فایل های صفحه گسترده Excel در برنامه های کاربردی .Net استفاده می شود. آن را با یک دستور واحد نصب کنید و شروع به ایجاد دفترچه ها، خواندن سلولها، اعمال سبک ها ، اضافه کردن قالب بندی مشروط، لینک های بالا، تأیید داده ها و فیلترهای خودکار همه بدون نیاز به Microsoft Excel یا هر کتابخانه محلی Office انجام دهید.

این کتابخانه یک API تمیز را در اطراف Workbook، Worksheet ، Cells و Cell ایجاد می کند که هر توسعه دهنده صفحه نمایش آشنا است. ساخت {پلاسیهولدر 5 ] برای بارگیری فایل موجود .xlsx یا ایجاد خالی ، دسترسی به ورق کار از طریق مجموعه Worksheets ، خواندن و نوشتن ارزش های سلول با PutValue و اعمال سبک ها از طريق GetStyle() / SetStyle(). فرمولها به عنوان رشته ذخیره شده اند و توسط بیننده در زمان باز ارزیابی می شوند نه توسط کتابخانه در هنگام اجرا.

از آنجا که این کتابخانه کد خالص مدیریت شده .NET بدون وابستگی های بومی است، به طور یکسان در ویندوز ، macOS ، لینوکس ، کانتینر Docker و محیط های بدون سرور مانند Azure Functions و AWS Lambda اجرا می شود. برای قابلیت های پیشرفته تر ، Aspose.Cells commercial edition را در نظر بگیرید. مجوز MIT اجازه استفاده تجاری نامحدود بدون حقوق نامه ، مجوز صندلی یا هزینه هر پیاده سازی را می دهد.

خواندن و نوشتن فایل های اکسل

  • XLSX read/write: کتاب های کاری را با استفاده از Workbook(fileName) و Save(fileName) باز کنید و ذخیره کنید.
  • ارزش سلول: ارزهای string، int, bool و decimal را با Cell.PutValue(value) بنویسید.
  • ** دسترسی به سلول:** با Cell.StringValue و Cell.Value ارزش ها را بخوانید.
  • ** فرمول ها:** رشته های فرموزی را از طریق Cell.Formula ذخیره کنید که توسط اکسل در باز ارزیابی شده اند.
  • مراجع صفحه کار: ورق های دسترسی به شاخص یا نام از طریق Workbook.Worksheets.

جایی که Aspose.Cells FOSS برای .NET استفاده می شود

  • ** تولید گزارش:** ایجاد گزارش های مارک دار اکسل در برنامه های سرور .NET.
  • ** صادرات داده:** نتایج پرس و جوی پایگاه داده را مستقیماً به .xlsx بدون Office بنویسید.
  • آوتوماتیک CI/CD: تولید دفترچه های نتیجه آزمایش در داخل Docker یا Linux CI.
  • ** جریان های کاری ETL:** ورق ورودی را بخوان، داده ها را تبدیل کن و دفترچه کار خروجی بنویسی.
  • ** عملکردهای بدون سرور:** در Azure Functions یا AWS Lambda اجرا کنید.

سبک گذاری سلول و قالب بندی مشروط

  • ** سبک فونت:** استفاده از bold، italic، اندازه و رنگ فونتی را با Style.Font.
  • ** الگوهای پر کردن:** رنگ پس زمینه را با Style.ForegroundColor و FillPattern.Solid تنظیم کنید.
  • ** قالب بندی مشروط:** اضافه کردن قوانین FormatConditionType.CellValue، Expression, ColorScale و { p.l.h.o.d.e.a.r.t.} از طریق Worksheet.ConditionalFormattings.
  • ** فرمت های شماره:** هر سلول یک رشته سفارشی برای شکل دادن عدد را تعیین کنید.

فرمت کردن موارد استفاده

  • ** گزارش های داشبورد:** برای برجسته کردن محدوده KPI، مقیاس رنگ و نوار داده ها را اعمال کنید.
  • ** ورق وضعیت:** از مجموعه ای از آیکون ها برای طبقه بندی بصری حالت ردیف استفاده کنید.
  • ** دفترچه های مالی:** ستونهای ارز و تاریخ با فرمت شماره داخلی را شکل دهید.
  • توسعه سرشناس: خطوط سرنشین با رنگ و کُلِر برای تمایز آن ها از ردیف های داده.

اعتبار سنجی داده ها و فیلترهای خودکار

  • ** قوانین اعتبارسنجی:** اضافه کردن اعتبارسیه های عدد کامل، اعشاری، لیست و تاریخ از طریق ValidationCollection.Add().
  • ** اپراتورها:** از OperatorType.Between، GreaterThan و LessThan استفاده کنید.
  • ** نوع اعتباربندی:** تنظیم ValidationType.WholeNumber، Decimal ، List،Date یا Custom.
  • ** فیلترهای خودکار:** فلتر های ستون را روی محدوده ای با AutoFilter و AutoFilter.FilterColumns اعمال کنید.
  • ** مناطق سلول:** محدوده های اعتبارسنجی را با استفاده از CellArea.CreateCellArea(start, end) تعریف کنید.

موارد استفاده اعتبار سنجی

  • ** فرم های ورودی داده:** قبل از به اشتراک گذاشتن دفترچه کار، واردات را محدود کنید.
  • ** قالب های بودجه:** سلولهای کامل بودجه با محدوده حداقل/بیشتر را اعمال کنید.
  • خطوط گزارش: قبل از تحویل داده های خروجی به ذینفعان، آن را تأیید کنید.
  • ** محدودیت های لیست:** سلول ها را به یک فهرست جدا کننده از قبل تعریف شده با ارزش های مجاز قفل کنید.

لینک های فوق العاده، دامنه نامگذاری شده و حفاظت از آن ها

  • ** لینک های فراگیر:** URLهای خارجی، مرجع سلول داخلی و پیوند نامه ها را از طریق HyperlinkCollection.Add() اضافه کنید.
  • ** دامنه های نامگذاری شده:** محدوده های جهانی و ورق بندی شده را با DefinedNameCollection.Add() تعریف کنید.
  • حفاظت از دفترچه کار: ساختار دفتر کار را با استفاده از WorkbookProtection قفل کنید.
  • حفاظت از ورق کار: برگه های جداگانه را با Worksheet.Protect() محافظت کنید.
  • ** تشخیص بار:** با استفاده از LoadDiagnostics و LoadIssue ورودی های نادرست را بررسی کنید.

موارد استفاده از حکومت و همکاری

  • توزیر قالب: برای جلوگیری از اضافه کردن فرمول به صورت تصادفی، صفحات را محافظت کنید.
  • ** کتاب های کار مشترک:** برای ایجاد مرجع متقابل ثابت از دامنه های نامگذاری شده استفاده کنید.
  • ** مسیرهای حسابرسی:** سلول ها را به URL های مستندات خارجی از طریق لینک های فوق العاده متصل کنید.
  • ** تأیید ورودی:** حفاظت را با تایید ترکیب کنید تا حاکمیت داده ها اجرا شود.

یک دفترچه کار ایجاد کنید و سلول ها را بنویسید

بسته NuGet را نصب کنید، سپس Workbook ایجاد کنید ، به اولین Worksheet دسترسی پیدا کنید و با استفاده از { PLACE HOLDR_4 ] ارزش ها را در سلولها بنویسید. مثال نشان می دهد که نوشتن انواع چندین مقدار و انجام یک سفر دور-گذراندن ذخیره سازی است.

dotnet add package Aspose.Cells_FOSS
using Aspose.Cells_FOSS;

var outputPath = "cell-data-roundtrip.xlsx";
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];

sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].PutValue(true);
sheet.Cells["D1"].PutValue(12.5m);
sheet.Cells["F1"].PutValue(10);
sheet.Cells["G1"].Formula = "=F1*2";
workbook.Save(outputPath);

var loaded = new Workbook(outputPath);
var loadedSheet = loaded.Worksheets[0];
Console.WriteLine(loadedSheet.Cells["A1"].StringValue);
Console.WriteLine(loadedSheet.Cells["G1"].Formula);

استفاده از قالب بندی مشروط

اضافه کردن قوانین قالب بندی مشروط برای برجسته سازی محدوده سلول ها. مثال یک قانون بین ارزش با پر کردن جامد، یک قاعده بیان، مقیاس رنگ، نوار داده و مجموعه آیکون را اعمال می کند.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Conditional Formatting";

for (var i = 0; i < 10; i++)
    sheet.Cells[i, 0].PutValue(i + 1);

var cfCol = sheet.ConditionalFormattings[sheet.ConditionalFormattings.Add()];
cfCol.AddArea(CellArea.CreateCellArea("A1", "A10"));
var rule = cfCol[cfCol.AddCondition(FormatConditionType.CellValue,
    OperatorType.Between, "3", "7")];
var style = rule.Style;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 255, 199, 206);
style.Font.Bold = true;
rule.Style = style;

workbook.Save("conditional-formatting.xlsx");

اضافه کردن لینک های بزرگ و دامنه های نامگذاری شده

لینک های خارجی و داخلی ایجاد کنید، سپس محدوده نامی را که به دفترچه کار یا یک صفحه خاص اختصاص دارد تعریف کنید.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Links";

sheet.Cells["A1"].PutValue("Docs");
var link = sheet.Hyperlinks[sheet.Hyperlinks.Add("A1", 1, 1, "https://example.com/docs")];
link.TextToDisplay = "Docs";
link.ScreenTip = "External docs";

var name = workbook.DefinedNames[workbook.DefinedNames.Add("GlobalRange", "='Links'!$A$1:$D$5")];
name.Comment = "Primary sample range";

workbook.Save("hyperlinks-and-names.xlsx");

سوالات متداول

Aspose.Cells FOSS برای .NET چیست؟

این یک کتابخانه منبع باز آزاد با مجوز MIT برای ایجاد، خواندن، اصلاح و ذخیره کردن دفترچه های کار Excel .xlsx بدون نیاز به Microsoft Office است.

چه فرمت های فایل پشتیبانی می شوند؟

.xlsx تنها فرمت خواندن / نوشتن پشتیبانی می شود. .xls ، .csv، .ods, .pdf , { place holder 5 ] و صادرات تصویر در این نسخه موجود نیست.

این نیاز به مایکروسافت آفیس دارد؟

نه. Aspose.Cells FOSS کد خالص مدیریت شده .NET بدون COM، P/Invoke، Office Interop یا وابستگی های کتابخانه بومی است.

چطوري نصبش کنم؟

dotnet add package Aspose.Cells_FOSS را اجرا کنید. این کتابخانه نیاز به .NET 6.0 یا بالاتر دارد. هیچ افزونه بومی ای برای کامپایل وجود ندارد.

آیا کتابخانه از فرمول بازشماری پشتیبانی می کند؟

رشته های فرمول به صورت کلمه ذخیره و بازیافت می شوند. کتابخانه محاسبه مجدد سرور را انجام نمی دهد فرمل ها توسط اکسل یا یک برنامه سازگار در open ارزیابی می شود.

ميتونم ازش در يه محصول تجاري استفاده کنم؟

بله، مجوز MIT اجازه استفاده تجاری بدون محدودیت رو میده بدون حقوق نامه و جواز نشستن یا هزینه های هر پیاده سازی.

  

منابع پشتیبانی و آموزش

 فارسی