Често задавани въпроси

Често задавани въпроси

Често задавани въпроси

Лицензиране и отворен код

Какъв е лицензът за 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 за .NET е чисто управляван код без COM, P/Invoke, Office Interop или зависимости от native библиотеки. Той работи на 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 набор.

 Български