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 CLI:

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 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.

 Русский