Osobine:

Osobine:

Aspose.Cells FOSS for .NET is a pure managed .NET library for creating, reading, and modifying Excel XLSX spreadsheets. The entry point is the Workbook Ova stranica sažima svaku glavnu oblast značajki s kratkim primjerima koda.

Radni list Stvoriti, učitati i sačuvati

Stvaranje novog radnog sveska s: new Workbook(). Uplatiti postojeću XLSX datoteku prosljeđivanjem puta za datotek u konstruktor. Koristite LoadOptions Za omogućiti otporno opterećenje. Workbook.Save(path) da se nastave promjene.

using Aspose.Cells_FOSS;

// New workbook
var wb = new Workbook();
wb.Worksheets[0].Cells["A1"].PutValue("Hello");
wb.Save("output.xlsx");

// Load with repair options
var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
try
{
    var loaded = new Workbook("input.xlsx", opts);
    Console.WriteLine(loaded.Worksheets[0].Cells["A1"].StringValue);
}
catch (WorkbookLoadException ex)
{
    Console.WriteLine("Load failed: " + ex.Message);
}

Podaci o stanicama i formule

Upotreba: Cell.PutValue() za pisanje nizova, cijela broja, decimalnih, boolean i DateTime Vrijednosti. Cell.Formula Da dodjeljujete niz formula kompatibilnih s Excelom. Pročitajte natrag prikazani tekst putem Cell.StringValue i sirova vrijednost putem: Cell.Value.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

ws.Cells["A1"].PutValue("Qty");
ws.Cells["B1"].PutValue("Price");
ws.Cells["C1"].PutValue("Total");
ws.Cells["A2"].PutValue(10);
ws.Cells["B2"].PutValue(4.99m);
ws.Cells["C2"].Formula = "=A2*B2";

wb.Save("data.xlsx");

var loaded = new Workbook("data.xlsx");
Console.WriteLine(loaded.Worksheets[0].Cells["C2"].StringValue); // 49.9

Stirenje ćelija

Pronaći i izmijeniti Style objekat za svaku ćeliju s: Cell.GetStyle() i u članku 1. Cell.SetStyle().-Ne, ne mogu. Style klasa daje Font (blatna, kurzivna i veličina), ForegroundColor, Pattern (vrsta: FillPattern), HorizontalAlignment (upotrebom HorizontalAlignmentType), i granična kontrola putem: Borders.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var cell = wb.Worksheets[0].Cells["A1"];
cell.PutValue("Styled Header");

var style = cell.GetStyle();
style.Font.Bold = true;
style.Font.Size = 14;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 198, 239, 206);
style.HorizontalAlignment = HorizontalAlignmentType.Center;
cell.SetStyle(style);

wb.Save("styled.xlsx");

Uslovno oblikovanje

Worksheet.ConditionalFormattings vraća a ConditionalFormattingCollection.Nazovi. Add() da kreira skup pravila, onda AddCondition() da se dodaju pravila koristeći FormatConditionType i u članku 1. OperatorType.Tipi podržanih stanja uključuju: CellValue, Expression, ColorScale, DataBar, i IconSet.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];
for (var i = 0; i < 10; i++)
    ws.Cells[i, 0].PutValue(i + 1);

var ruleSet = ws.ConditionalFormattings[ws.ConditionalFormattings.Add()];
ruleSet.AddArea(CellArea.CreateCellArea("A1", "A10"));
var rule = ruleSet[ruleSet.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "3", "7")];
var ruleStyle = rule.Style;
ruleStyle.Pattern = FillPattern.Solid;
ruleStyle.ForegroundColor = Color.FromArgb(255, 255, 199, 206);
rule.Style = ruleStyle;

wb.Save("cf.xlsx");

Provedba podataka

Worksheet.Validations vraća a ValidationCollection.Nazovi. Add(CellArea) da se stvori Validation za opseg ćelija. Type imovina koja koristi ValidationType (List, Decimal,ili Custom) Konfiguriše se: Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle, i ErrorMessage.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

var listVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A1", "A10"))];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,Closed,Pending\"";
listVal.InCellDropDown = true;

var numVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("B1", "B10"))];
numVal.Type = ValidationType.Decimal;
numVal.Operator = OperatorType.Between;
numVal.Formula1 = "0";
numVal.Formula2 = "100";
numVal.ShowError = true;

wb.Save("validation.xlsx");

Automatski filter

Worksheet.AutoFilter izloži AutoFilter -Obijek. AutoFilter.Range Da definiše raspon naslovnih redova. Access AutoFilter.FilterColumns (skup) i poziv Add(columnIndex) za aktiviranje filtracije na određenoj kolumni.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

ws.Cells["A1"].PutValue("Name");
ws.Cells["B1"].PutValue("Region");
ws.Cells["C1"].PutValue("Sales");
ws.Cells["A2"].PutValue("Alice"); ws.Cells["B2"].PutValue("North"); ws.Cells["C2"].PutValue(1200);

ws.AutoFilter.Range = "A1:C1";
ws.AutoFilter.FilterColumns.Add(1);

wb.Save("filter.xlsx");

Hiperlinkovi i definirana imena

Worksheet.Hyperlinks je u skladu s člankom HyperlinkCollection.Nazovi. Add() za ubacivanje vanjskih URL-ova, unutarnjih referenci ćelija ili mailto linkova. Set Hyperlink.TextToDisplay i u članku 1. Hyperlink.ScreenTip za tekst koji se obraća korisniku. Workbook.DefinedNames je u skladu s člankom DefinedNameCollection; poziv Add(name, refersTo) za kreiranje imenovanih opsega.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];

ws.Cells["A1"].PutValue("Docs");
var link = ws.Hyperlinks[ws.Hyperlinks.Add("A1", 1, 1, "https://docs.aspose.org/cells/net/")];
link.TextToDisplay = "Documentation";

wb.DefinedNames[wb.DefinedNames.Add("DataRange", "Sheet1!$A$1:$D$10")].Comment = "Main data range";

wb.Save("links.xlsx");

Postavljanje stranice

Worksheet.PageSetup kontrolne funkcije: marže za tisak, smjernica, veličina papira, područje štampanja, redovi/kolone naslova, zaglavlja i nogi i prekida stranica. PageOrientationType i u članku 1. PaperSizeType -Ne, ne mogu.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ps = wb.Worksheets[0].PageSetup;
ps.Orientation = PageOrientationType.Landscape;
ps.PaperSize = PaperSizeType.PaperA4;
ps.PrintArea = "$A$1:$H$50";
ps.CenterHeader = "My Report";
ps.CenterHorizontally = true;
ps.AddHorizontalPageBreak(25);

wb.Save("paged.xlsx");

Upravljanje radnim listom

Dodaj, preimenuj, sakrij i ponovno uređivati radne listove putem WorksheetCollection. WorksheetCollection.Add(name) vraća indeks novog lista. Set Worksheet.VisibilityType korištenje VisibilityType. spajanje stanica s Cells.Merge() i mjerenje veličine redova/stolpa putem: Cells.Rows i u članku 1. Cells.Columns.

using Aspose.Cells_FOSS;

var wb = new Workbook();
wb.Worksheets[0].Name = "Summary";
var dataIdx = wb.Worksheets.Add("Data");
wb.Worksheets[dataIdx].VisibilityType = VisibilityType.Hidden;
wb.Worksheets.ActiveSheetName = "Summary";

var ws = wb.Worksheets["Summary"];
ws.Cells["A1"].PutValue("Title");
ws.Cells.Merge(0, 0, 1, 4);
ws.Cells.Rows[0].Height = 30d;
ws.Cells.Columns[0].Width = 20d;

wb.Save("worksheets.xlsx");

Savjeti i najbolje prakse

• Uvijek uhvati. WorkbookLoadException Prilikom učitavanja datoteka s putanja koje su dostavljeni od strane korisnika.
• Upotreba: Cell.PutValue() s tačnim .NET tipom koji namjeravate pohraniti prolaz decimal za valutu, DateTime za sastanke.
• Čitaj. Cell.StringValue za prikaz teksta; upotrebu Cell.Value Kada vam je potreban.NET objekt.
• Stvoriti uvjetne formatacije pravila skupovi na najširem rasponu vam je potrebno Pravila po redu su skupa u velikim listovima.
• Zovi me. wb.Save() jednom na kraju umjesto nakon svake ćelije pisati.

Zajednički problemi

FAQ

Da li je za Aspose.Cells FOSS u .NET-u potreban Microsoft Office?

Ne, biblioteka je čista upravljana koda bez ovisnosti o Officeu, Excel-u ili COM interop.

Koje su formate datoteka podržane?

XLSX (čitati i pisati). CSV, ODS, PDF i binarni XSL nisu podržani u ovom izdanju.

Mogu li koristiti ovu knjižnicu u komercijalnoj aplikaciji?

Da, Aspose.Cells FOSS je objavljen pod MIT licencom koja dozvoljava neograničenu komercijalnu upotrebu bez plaćanja autorskih prava.

Što je minimalna .NET verzija?

.NET 6.0 ili noviji.

Kako primjenjivati boju pozadine na ćeliju?

Sastavljeno style.Pattern = FillPattern.Solid i u članku 1. style.ForegroundColor = Color.FromArgb(...), onda nazovi cell.SetStyle(style).

Svrha referentnog API-a