Вступ
Aspose.Cells FOSS для .NET — це чиста бібліотека на керованому коді, ліцензована за MIT, для читання, запису та маніпулювання робочими книгами Excel .xlsx без будь-якої залежності від Microsoft Office. Встановлена як пакет Aspose.Cells_FOSS NuGet, вона інтегрується в будь-який проект .NET — консольні додатки, веб-API, фонові воркери та безсерверні функції.
У цьому дописі представлено покроковий огляд функцій публічного API, показано, що можливо, і як викликати кожну можливість із коду C#.
Огляд функцій
Життєвий цикл робочої книги та листа
Точкою входу для будь-якої операції є клас Workbook. Створіть його з нуля за допомогою new Workbook() або завантажте існуючий .xlsx за допомогою new Workbook(filePath) чи new Workbook(stream). Перемикайте листи через Workbook.Worksheets, встановлюйте Worksheet.Name та Worksheet.VisibilityType, і зберігайте за допомогою Workbook.Save(). Для пошкоджених файлів передайте екземпляр LoadOptions з TryRepairPackage = true та TryRepairXml = true.
using Aspose.Cells_FOSS;
var options = new LoadOptions
{
TryRepairPackage = true,
TryRepairXml = true,
};
try
{
_ = new Workbook("sample.xlsx", options);
}
catch (WorkbookLoadException exception)
{
Console.WriteLine(exception.Message);
}
Дані клітинок та формули
Записуйте значення у клітинки за допомогою Cell.PutValue() — перевантаження приймають string, int, double, decimal, bool та DateTime. Читайте значення назад за допомогою Cell.Value, Cell.StringValue і Cell.Formula. Встановлюйте формули Excel за допомогою властивості Cell.Formula; рядок формули зберігається при збереженні і переживає цикл перезавантаження.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";
workbook.Save("hello.xlsx");
var loaded = new Workbook("hello.xlsx");
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].Formula);
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].StringValue);
Стилізація клітинок
Застосуйте об’єкти Style для керування шрифтом, заливкою, межами, форматом чисел та вирівнюванням. Отримайте поточний стиль за допомогою Cell.GetStyle(), змініть його, а потім затвердіть за допомогою Cell.SetStyle(). Для заливки фону встановіть Style.Pattern = FillPattern.Solid і призначте Color до Style.ForegroundColor. Використовуйте Cells.Merge() для охоплення діапазонів клітинок.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var cell = workbook.Worksheets[0].Cells["A1"];
cell.PutValue("Styled");
var style = cell.GetStyle();
style.Font.Bold = true;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 241, 196, 15);
cell.SetStyle(style);
Console.WriteLine($"{cell.StringValue} / Bold={cell.GetStyle().Font.Bold}");
Умовне форматування
Прикріпіть правила умовного форматування до діапазонів клітинок за допомогою ConditionalFormattingCollection. Правила підтримують FormatConditionType.CellValue, Expression, ColorScale, DataBar та IconSet. Використовуйте OperatorType для вказання операторів порівняння (Between, Equal, GreaterThan тощо), призначте Style відповідним клітинкам і налаштуйте пріоритет та поведінку «зупинити, якщо істина» для кожного правила.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
var cfCollection = sheet.ConditionalFormattings[sheet.ConditionalFormattings.Add()];
cfCollection.AddArea(CellArea.CreateCellArea("A1", "A10"));
var rule = cfCollection[cfCollection.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");
Перевірка даних
Додайте обмеження вводу до клітинок за допомогою Worksheet.Validations. Підтримувані типи перевірки включають ValidationType.List, Decimal, Custom та інші. Налаштуйте підказки вводу (InputTitle, InputMessage) та повідомлення про помилки (ErrorTitle, ErrorMessage, ValidationAlertType). Використовуйте CellArea.CreateCellArea() для визначення діапазону перевірки та Validation.AddArea() для застосування правила до додаткових діапазонів.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Validation Sheet";
var listIdx = sheet.Validations.Add(CellArea.CreateCellArea("A1", "A3"));
var listVal = sheet.Validations[listIdx];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,Closed\"";
listVal.IgnoreBlank = true;
listVal.InCellDropDown = true;
listVal.ShowInput = true;
listVal.InputTitle = "Status";
listVal.InputMessage = "Pick a status";
listVal.ShowError = true;
listVal.ErrorTitle = "Invalid";
listVal.ErrorMessage = "Choose from the list";
workbook.Save("validations-sample.xlsx");
Налаштування сторінки та параметри друку
Налаштуйте макет друку за допомогою Worksheet.PageSetup. Встановіть поля (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, масштаб, область друку, рядки та стовпці заголовка, верхні та нижні колонтитули, а також розриви сторінок. Усі налаштування зберігаються під час збереження-завантаження.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Print Sheet";
sheet.Cells["A1"].PutValue("Title");
var pageSetup = sheet.PageSetup;
pageSetup.Orientation = PageOrientationType.Landscape;
pageSetup.PaperSize = PaperSizeType.PaperA4;
pageSetup.PrintArea = "$A$1:$C$10";
pageSetup.PrintTitleRows = "$1:$2";
pageSetup.LeftHeader = "Left Header";
pageSetup.CenterFooter = "Center Footer";
pageSetup.PrintGridlines = true;
pageSetup.CenterHorizontally = true;
workbook.Save("page-setup-sample.xlsx");
Налаштування листа та захист
Керуйте відображенням окремих листів за допомогою Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom та TabColor. Захищайте листи за допомогою Worksheet.Protect() і налаштовуйте детальні прапори Protection (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells). Керуйте висотою рядків, шириною стовпців, прихованими рядками/стовпцями та об’єднаними ділянками за допомогою Cells.Rows, Cells.Columns та Cells.Merge().
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var layout = workbook.Worksheets[0];
layout.Name = "Layout";
layout.VisibilityType = VisibilityType.Hidden;
layout.TabColor = Color.FromArgb(255, 34, 68, 102);
layout.ShowGridlines = false;
layout.Zoom = 85;
layout.Protect();
layout.Protection.FormatCells = true;
layout.Protection.InsertRows = true;
layout.Cells["A1"].PutValue("Merged");
layout.Cells.Rows[1].Height = 22.5d;
layout.Cells.Columns[0].Width = 18.25d;
layout.Cells.Merge(0, 0, 2, 2);
workbook.Save("worksheet-settings-sample.xlsx");
Гіперпосилання та іменовані діапазони
Додайте зовнішні, внутрішні та mailto: гіперпосилання за допомогою HyperlinkCollection.Add(). Встановіть Hyperlink.TextToDisplay та Hyperlink.ScreenTip для видимих користувачем міток. Визначте іменовані діапазони на рівні книги або листа за допомогою DefinedNameCollection.Add() — іменовані діапазони служать стабільними якорями формул і джерелами даних діаграм, які зберігаються після повторного завантаження файлу.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
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 documentation";
var name = workbook.DefinedNames[workbook.DefinedNames.Add("PrimaryRange", "='Sheet1'!$A$1:$D$5")];
name.Comment = "Primary data range";
workbook.Save("hyperlinks-names.xlsx");
Console.WriteLine("Hyperlinks: " + sheet.Hyperlinks.Count);
Console.WriteLine("Defined names: " + workbook.DefinedNames.Count);
Швидкий старт
dotnet add package Aspose.Cells.FOSSusing Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";
workbook.Save("output.xlsx");
Підтримувані формати
| Формат | Розширення | Читати | Запис |
|---|---|---|---|
| Xlsx | .xlsx | ✓ | ✓ |
| Auto | (різні) | ✓ | — |
Відкритий код та ліцензування
Aspose.Cells FOSS для .NET опубліковано під ліцензією MIT і розповсюджується через NuGet як Aspose.Cells_FOSS. Підходить як для open-source, так і для комерційних проєктів.