Caracteristici

Caracteristici

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 class, care oferă acces la foi de lucru, nume definite și operațiuni de salvare/încărcare. Această pagină rezumă fiecare zonă majoră cu exemple scurte de cod.

Cărți de lucru Crea, încărca și salva

Crearea unei cărţi de lucru cu: new Workbook(). Încărcați un fișier XLSX existent prin transmiterea unei căi de dosar la constructor. Utilizați LoadOptions pentru a permite încărcarea tolerantă la defecte. Workbook.Save(path) să persiste schimbările.

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

Datele și formulele celulelor

Utilizare: Cell.PutValue() pentru a scrie șiruri, integer, zecimale, boolean și DateTime Valori. Setate Cell.Formula pentru a atribui un șir de formule compatibile cu Excel. Citeste înapoi textul afișat prin intermediul Cell.StringValue și valoarea brută prin intermediul: 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

Styling de celule

Obțineți și modificați Style Obiect pentru orice celulă cu: Cell.GetStyle() și de: Cell.SetStyle().- Ce ? Style clasa oferă Font (în scris greșit, în cursiv, mărime, nume), ForegroundColor, Pattern (de tip FillPattern), HorizontalAlignment (folosind HorizontalAlignmentType), și controlul la frontieră prin intermediul 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");

Formatare condiționată

Worksheet.ConditionalFormattings returnează un ConditionalFormattingCollection.Sună-mă. Add() pentru a crea un set de reguli, apoi AddCondition() pentru a adăuga reguli folosind FormatConditionType și de: OperatorType.Tipurile de condiții suportate includ: 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");

Validarea datelor

Worksheet.Validations returnează un ValidationCollection.Sună-mă. Add(CellArea) pentru a crea o Validation Setarea numărului de date pentru o gamă celulară. Type proprietate folosind ValidationType (List, Decimal, sau Custom) Configurație 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");

Filtru automat

Worksheet.AutoFilter expune la public AutoFilter Obiectul. AutoFilter.Range Pentru a defini intervalul rândului de intitulare. Access AutoFilter.FilterColumns (o colecţie) şi apelul Add(columnIndex) pentru a activa filtrarea pe o anumită coloană.

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

Hyperlink-uri și nume definite

Worksheet.Hyperlinks este o HyperlinkCollection.Sună-mă. Add() pentru a introduce URL-uri externe, referințe interne ale celulelor sau link-urile mailto. Set Hyperlink.TextToDisplay și de: Hyperlink.ScreenTip pentru textul adresat utilizatorului. Workbook.DefinedNames este o DefinedNameCollection; apelul Add(name, refersTo) pentru a crea intervale numite.

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

Configurația paginii

Worksheet.PageSetup controale marjele de imprimare, orientarea, dimensiunea hârtiei, zona de printare , rândurile/columnele titlului, capetele, piciorul și pauza paginii. PageOrientationType și de: PaperSizeType - Nu, nu.

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

Gestionarea fișei de lucru

Adăugați, redenumiți-vă, ascundeți și reordonați fișele de lucru prin WorksheetCollection. WorksheetCollection.Add(name) returnă indexul noii foi. Set Worksheet.VisibilityType utilizarea VisibilityType. Fusează celulele cu: Cells.Merge() și de control a dimensiunii rândului/colonilor prin intermediul Cells.Rows și de: 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");

Sfaturi şi cele mai bune practici

• Întotdeauna prind. WorkbookLoadException atunci când se încărcă fișierele din căile furnizate de utilizator.
• Utilizare: Cell.PutValue() cu exact tipul .NET pe care intenționați să-l stocați pass decimal pentru monedă, DateTime pentru întâlniri.
• Citeşte. Cell.StringValue pentru textul afișat; utilizare Cell.Value când ai nevoie de obiectul .NET brut.
• Crearea seturilor de reguli condiționate de formatare pe cea mai largă gamă necesară Regulile per-rând sunt scumpe în foi mari.
• Sună-mă. wb.Save() o dată la sfârșit, mai degrabă decât după fiecare celulă scrie.

Probleme comune

FAQ

Aspose.Cells FOSS pentru .NET necesită Microsoft Office?

Nu. Biblioteca este pur cod gestionat fără dependență de Office, Excel sau COM interop.

Ce formate de fişiere sunt suportate?

CSV, ODS, PDF și XLS binar nu sunt suportate în această versiune.

Pot folosi această bibliotecă într-o aplicaţie comercială?

Da. Aspose.Cells FOSS este publicat sub licenţa MIT, care permite utilizarea comercială nelimitată fără redevenţe.

Care este versiunea minimă .NET?

.NET 6.0 sau mai târziu.

Cum aplic o culoare de fundal la o celulă?

Setare style.Pattern = FillPattern.Solid și de: style.ForegroundColor = Color.FromArgb(...), apoi sună-mă . cell.SetStyle(style).

Rezultatele de la data aplicării.