Uvod

Aspose.Cells FOSS for .NET je čista biblioteka upravljanog koda, licencirana pod MIT-om, za čitanje, pisanje, i manipulaciju Excel .xlsx radnim knjigama bez ikakve zavisnosti od Microsoft Office-a. Instalirana kao Aspose.Cells_FOSS NuGet paket, integriše se u bilo koji .NET projekat — konzolne aplikacije, web API-je, pozadinske radnike i serverless funkcije.

Ovaj post pruža detaljno objašnjenje funkcija po funkciju javnog API‑ja, pokazujući šta je moguće i kako pozvati svaku mogućnost iz C# koda.

Pregled funkcija

Životni ciklus radne sveske i radnog lista

Ulazna tačka za svaku operaciju je klasa Workbook. Kreirajte je od nule pomoću new Workbook(), ili učitajte postojeću .xlsx pomoću new Workbook(filePath) ili new Workbook(stream). Navigirajte listove putem Workbook.Worksheets, postavite Worksheet.Name i Worksheet.VisibilityType, i sačuvajte pomoću Workbook.Save(). Za oštećene fajlove, prosledite instancu LoadOptions sa TryRepairPackage = true i 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);
}

Podaci o ćelijama i formule

Pišite vrednosti u ćelije pomoću Cell.PutValue() — preopterećenja prihvataju string, int, double, decimal, bool i DateTime. Čitajte vrednosti nazad putem Cell.Value, Cell.StringValue i Cell.Formula. Postavite Excel formule pomoću svojstva Cell.Formula; string formule se čuva pri čuvanju i preživljava ciklus ponovnog učitavanja.

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);

Stilizovanje ćelija

Primeni Style objekte za kontrolu fonta, popunjavanja, ivica, formata broja i poravnanja.
Preuzmi trenutni stil pomoću Cell.GetStyle(), izmeni ga, zatim potvrdi sa
Cell.SetStyle(). Za pozadinsko popunjavanje, postavi Style.Pattern = FillPattern.Solid i dodeli
Color na Style.ForegroundColor. Koristi Cells.Merge() za proširenje opsega ćelija.

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}");

Uslovno formatiranje

Priložite pravila uslovnog formatiranja opsezima ćelija putem ConditionalFormattingCollection.
Pravila podržavaju FormatConditionType.CellValue, Expression, ColorScale, DataBar, i
IconSet. Koristite OperatorType za određivanje operatora poređenja (Between, Equal,
GreaterThan, itd.), dodelite Style odgovarajućim ćelijama i konfigurišite prioritet i
ponašanje stop‑if‑true po pravilu.

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");

Валидација података

Dodajte ograničenja unosa u ćelije koristeći Worksheet.Validations. Podržani tipovi validacije uključuju ValidationType.List, Decimal, Custom i još toga. Konfigurišite upite za unos (InputTitle, InputMessage) i poruke o greškama (ErrorTitle, ErrorMessage, ValidationAlertType). Koristite CellArea.CreateCellArea() da definišete validirani opseg i Validation.AddArea() da primenite pravilo na dodatne opsege.

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");

Podešavanje stranice i opcije štampe

Konfigurišite raspored štampe putem Worksheet.PageSetup. Postavite margine (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, skalu, oblast štampe, naslove redova i kolona, zaglavlja i podnožja i prekide stranica. Sva podešavanja opstaju kroz ciklus čuvanja‑učitavanja.

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");

Podešavanja radnog lista i zaštita

Kontrolišite prikaz po listu pomoću Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom i TabColor. Zaštitite listove pomoću Worksheet.Protect() i konfigurišite detaljna Protection zastavice (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells). Upravljajte visinom reda, širinom kolone, skrivenim redovima/kolonama i spojenim regionima putem Cells.Rows, Cells.Columns i 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");

Хипервезе и именовани опсези

Dodajte spoljne, interne i mailto: hiperveze putem HyperlinkCollection.Add().
Postavite Hyperlink.TextToDisplay i Hyperlink.ScreenTip za oznake vidljive korisniku.
Definišite imenovane opsege na nivou radne sveske ili lista koristeći DefinedNameCollection.Add() — imenovani opsegi služe kao stabilna sidrišta formula i izvori podataka za grafikone koji preživljavaju ponovno učitavanje datoteke.

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);

Brzi početak

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");

Podržani formati

FormatEkstenzijaČitanjePisanje
Xlsx.xlsx✓✓
Auto(razni)✓—

Open Source i licenciranje

Aspose.Cells FOSS za .NET je objavljen pod MIT licencom i distribuira se putem NuGet-a kao Aspose.Cells_FOSS. Pogodan je za open-source i komercijalne projekte podjednako.

Početak

Повезани ресурси