Въведение

Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, Манипулация на Excel .xlsx работна книга без всяка зависимост от Microsoft Office. инсталиран като Върху него Aspose.Cells_FOSS Пакет NuGet, той се интегрира във всеки .NET проект — конзолни приложения, уеб АПИ, работници на фонове и безсерверни функции.

Този пост предоставя функционен ход на публичния 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_FOSS

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("output.xlsx");

Подкрепени формати

ФорматътРазширяванеПрочететеПисане
Xlsx.Xlsx на✓✓
Автомобилът(Възможно е да се✓—

Отворени източници и лицензиране

Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as Aspose.Cells_FOSS.Подходящ е за отворени и търговски проекти.

Започваме