Aspose.Cells FOSS
.NET
سوالات متداول

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

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

مجوزدهی و منبع باز

مجوز Aspose.Cells FOSS برای .NET چیست؟

Aspose.Cells FOSS for .NET تحت MIT License منتشر شده است. شما آزادید که کتابخانه را در هر پروژه‌ای استفاده، کپی، تغییر و توزیع کنید — از جمله نرم‌افزارهای تجاری — بدون حق‌الامتیاز یا نیاز به ذکر منبع فراتر از اطلاعیهٔ مجوز. کد منبع در دسترس است در github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-NET.

آیا می‌توانم از Aspose.Cells FOSS برای .NET در یک محصول تجاری استفاده کنم؟

بله. مجوز MIT اجازه استفاده تجاری بدون محدودیت را می‌دهد. هیچ محدودیتی برای تعداد صندلی‌ها، هزینه‌های زمان اجرا یا نیازهای اشتراک وجود ندارد.

آیا این همان Aspose.Cells تجاری برای .NET است؟

نه. Aspose.Cells FOSS یک کتابخانه جداگانه، مستقل و منبع باز است. این کتابخانه فقط خواندن/نوشتن XLSX را پشتیبانی می‌کند. نسخه تجاری Aspose.Cells برای .NET فرمت‌های اضافی متعددی (XLS، ODS، PDF، HTML و غیره) و ویژگی‌هایی که خارج از دامنه این انتشار FOSS هستند را پشتیبانی می‌کند.

نصب و پیش‌نیازها

چگونه Aspose.Cells FOSS را برای .NET نصب کنم؟

نصب از طریق خط فرمان dotnet:

dotnet add package Aspose.Cells_FOSS

یا از طریق کنسول مدیر بسته Visual Studio:

Install-Package Aspose.Cells_FOSS

کدام نسخه‌های .NET پشتیبانی می‌شوند؟

.NET 6.0 یا بالاتر (.NET 8.0 LTS توصیه می‌شود). این کتابخانه کد خالص مدیریت‌شده است و هدف‌گذاری برای .NET Framework ندارد.

آیا وابستگی‌های بومی وجود دارد؟

نه. Aspose.Cells FOSS برای .NET کد کاملاً مدیریت‌شده‌ای است که هیچ وابستگی COM، P/Invoke، Office Interop یا کتابخانه بومی ندارد. این محصول بر روی Windows، macOS، Linux، Docker و محیط‌های serverless اجرا می‌شود.

پشتیبانی از فرمت

کدام فرمت‌های فایل می‌توانند توسط Aspose.Cells FOSS برای .NET خوانده و نوشته شوند؟

فرمتپسوندخواندننوشتن
Xlsx.xlsx✓✓

آیا کتابخانه می‌تواند فایل‌های CSV، XLS، ODS یا PDF را بخواند یا بنویسد؟

خیر. فقط XLSX (Open XML) در این نسخه پشتیبانی می‌شود. CSV، XLS باینری، ODS، PDF، HTML و خروجی تصویر در دسترس نیستند.

آیا می‌توانم یک فایل XLSX که کمی خراب است را بارگذاری کنم؟

بله. یک شیء LoadOptions را با TryRepairPackage = true و TryRepairXml = true به سازنده Workbook پاس بدهید. کتابخانه سعی خواهد کرد فایل را بازیابی کند. اگر فایل غیرقابل بازیابی باشد، یک WorkbookLoadException پرتاب می‌شود.

using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
var wb = new Workbook("file.xlsx", opts);
Console.WriteLine("Repairs applied: " + wb.LoadDiagnostics.HasRepairs);

استفاده از API

چگونه یک کتاب کار جدید ایجاد کنم و داده‌های سلول را بنویسم؟

یک نمونه از Workbook ایجاد کنید، از طریق Workbook.Worksheets[0] به اولین برگه کاری دسترسی پیدا کنید، و برای نوشتن داده‌ها Cell.PutValue() را فراخوانی کنید. با Workbook.Save(path) ذخیره کنید.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

ws.Cells["A1"].PutValue("Name");
ws.Cells["B1"].PutValue("Score");
ws.Cells["A2"].PutValue("Alice");
ws.Cells["B2"].PutValue(95);
ws.Cells["C2"].Formula = "=B2*1.1";

wb.Save("output.xlsx");

چگونه مقادیر سلول‌ها را از یک فایل XLSX موجود بخوانم؟

مسیر فایل را به سازنده Workbook بدهید و مقادیر سلول‌ها را از طریق Cell.StringValue (رشته نمایش) یا Cell.Value (شیء خام .NET) بخوانید.

using Aspose.Cells_FOSS;

var wb = new Workbook("output.xlsx");
var ws = wb.Worksheets[0];

Console.WriteLine(ws.Cells["A2"].StringValue);  // Alice
Console.WriteLine(ws.Cells["B2"].StringValue);  // 95
Console.WriteLine(ws.Cells["C2"].Formula);       // =B2*1.1

چگونه می‌توانم به یک سلول استایل اعمال کنم؟

Cell.GetStyle() را فراخوانی کنید تا Style فعلی را بازیابی کنید، ویژگی‌ها را تغییر دهید و Cell.SetStyle(style) را فراخوانی کنید تا آن‌ها را اعمال کنید.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var cell = wb.Worksheets[0].Cells["A1"];
cell.PutValue("Header");

var style = cell.GetStyle();
style.Font.Bold = true;
style.Font.Size = 14;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = System.Drawing.Color.FromArgb(255, 198, 239, 206);
style.HorizontalAlignment = HorizontalAlignmentType.Center;
cell.SetStyle(style);

wb.Save("styled.xlsx");

چگونه یک برگه کاری جدید اضافه کنم؟

متد Workbook.Worksheets.Add(name) را فراخوانی کنید. این متد شاخص عدد صحیح شیت جدید را برمی‌گرداند؛ از آن برای دسترسی به شیء شیت استفاده کنید.

using Aspose.Cells_FOSS;

var wb = new Workbook();
wb.Worksheets[0].Name = "Summary";
var dataIdx = wb.Worksheets.Add("Data");
wb.Worksheets[dataIdx].Cells["A1"].PutValue("Data sheet");
wb.Save("multi.xlsx");

چگونه اعتبارسنجی داده را به یک بازه سلولی اضافه کنم؟

دسترسی Worksheet.Validations، Add(CellArea) را فراخوانی کنید تا یک Validation ایجاد کنید، سپس Type آن را با استفاده از ValidationType تنظیم کنید.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

var val = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A1", "A10"))];
val.Type = ValidationType.List;
val.Formula1 = "\"Open,Closed,Pending\"";
val.InCellDropDown = true;

wb.Save("validated.xlsx");

محدودیت‌های شناخته‌شده

کدام ویژگی‌ها پشتیبانی نمی‌شوند؟

موارد زیر خارج از حوزه فعلی Aspose.Cells FOSS برای .NET هستند:

  • فرمت‌های غیر از XLSX (بدون XLS، CSV، ODS، PDF، HTML یا خروجی تصویر)
  • جداول محوری و نمودارهای محوری
  • ماکروهای VBA
  • اسپارکلاین‌ها
  • متن غنی در یک سلول (قالب‌های ترکیبی فونت)

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

رشته‌های فرمول به‌صورت دقیق ذخیره و بازیابی می‌شوند. مقادیر محاسبه‌شده از نتیجهٔ ذخیره‌شده در فایل XLSX خوانده می‌شوند. کتابخانه بازآفرینی فرمول را در سمت سرور انجام نمی‌دهد — فرمول هنگام باز کردن توسط Excel یا برنامه‌ای سازگار بازمحاسبه می‌شود.

آیا می‌توانم یک کتاب کار را با رمز عبور محافظت کنم؟

محافظت در سطح کاربرگ از طریق Worksheet.Protect() و Worksheet.Protection در دسترس است. رمزگذاری رمز عبور در سطح کتاب‌کار در سطح API فعلی موجود نیست.

 فارسی