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 License дозволяє необмежене комерційне використання. Немає обмежень на кількість місць, плат за виконання чи вимог щодо підписки.

Чи це те саме, що комерційна Aspose.Cells для .NET?

Ні. Aspose.Cells FOSS — це окрема, незалежна бібліотека з відкритим вихідним кодом. Вона підтримує лише читання/запис XLSX. Комерційна Aspose.Cells для .NET підтримує багато додаткових форматів (XLS, ODS, PDF, HTML тощо) та функції, які виходять за межі цього випуску FOSS.

Встановлення та вимоги

Як встановити Aspose.Cells FOSS для .NET?

Встановити за допомогою dotnet CLI:

dotnet add package Aspose.Cells_FOSS

Або через Visual Studio Package Manager Console:

Install-Package Aspose.Cells_FOSS

Які версії .NET підтримуються?

.NET 6.0 або новіший (.NET 8.0 LTS рекомендовано). Бібліотека є чистим керованим кодом і не орієнтована на .NET Framework.

Чи є якісь нативні залежності?

Ні. Aspose.Cells FOSS for .NET — це чистий керований код без COM, P/Invoke, Office Interop або залежностей від нативних бібліотек. Він працює на Windows, macOS, Linux, Docker та безсерверних середовищах.

Підтримка форматів

Які формати файлів може читати та записувати 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.

 Українська