Característiques

Característiques

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, que proporciona accés a fitxes de treball, noms definits i operacions d’encapçalada/save. Aquesta pàgina resumeix cada àrea principal amb breus exemples de codi.

Carregador Crear, carregar i guardar

Crear un llibre de treball nou amb: new Workbook().Carregar un arxiu XLSX existent passant una ruta de fitxer al constructor. Utilitzar LoadOptions Per permetre la càrrega tolerant a falles. Workbook.Save(path) per a mantenir els canvis.

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

Dades i fórmules de cèl·lules

Utilització: Cell.PutValue() per escriure cadenes, enters, decimals, booleans i DateTime Valors. Ajustats Cell.Formula per assignar una cadena de fórmules compatible amb Excel. Llegir text a través del programa Cell.StringValue i el valor brut per via de: 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

Estilitzament de cèl·lules

Recuperar i modificar el sistema de correcció. Style objecte per a qualsevol cèl·lula amb: Cell.GetStyle() i de la Cell.SetStyle().El . Style classe proporciona Font (en negreta, en cursiva, mida, nom), ForegroundColor, Pattern (de tipus FillPattern), HorizontalAlignment (utilitzant el nom de l’empresa) HorizontalAlignmentType), i control fronterers a través de la CE. 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");

Formatació condicional

Worksheet.ConditionalFormattings retorna un ConditionalFormattingCollection.- Truca. Add() per crear un conjunt de regles, llavors AddCondition() per afegir regles utilitzant FormatConditionType i de la OperatorType.Els tipus de condicions suportades inclouen: 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");

Validació de dades

Worksheet.Validations retorna un ValidationCollection.- Truca. Add(CellArea) crear un Validation per a una gamma de cèl·lules. Type propietat utilitzant ValidationType (List, Decimal, o Custom) Configuració 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");

Filtre automàtic

Worksheet.AutoFilter exposa el AutoFilter object. Set AutoFilter.Range Per definir el rang de línies d’encapçallament. Access AutoFilter.FilterColumns (una col·lecció) i crida a la Add(columnIndex) per activar el filtratge en una columna específica.

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

Hipervincles i noms definits

Worksheet.Hyperlinks és un HyperlinkCollection.- Truca. Add() per inserir URLs externes, referències internes de cèl·lules o enllaços mailto. Set Hyperlink.TextToDisplay i de la Hyperlink.ScreenTip per a text orientat cap a l’usuari. Workbook.DefinedNames és un DefinedNameCollection; trucar Add(name, refersTo) per crear rangs nomenats.

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

Configuració de pàgines

Worksheet.PageSetup Controles de marges d’impressió, orientació, mida del paper, àrea d"impresión, línies/columnes de títol, encabezaments, peu de pàgina i interromptes. PageOrientationType i de la PaperSizeType Enums.

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

Gestió de la fulla d’estudi

Agregar, renomenar, amagar i reordenar les fitxes a través de WorksheetCollection. WorksheetCollection.Add(name) Retorna l’índex de la nova fulla. Set Worksheet.VisibilityType utilitzant VisibilityType. Fusionar cèl·lules amb Cells.Merge() i dimensionament de la fila/columna per mitjà del sistema d’escalfament. Cells.Rows i de la 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");

Consells i millors pràctiques

• Sempre agafar. WorkbookLoadException quan es carguen arxius des de camins subministrats per l’usuari.
• Utilització: Cell.PutValue() amb el tipus .NET exacte que pretén emmagatzemar pass decimal per moneda, DateTime per a dates.
• Llegeix. Cell.StringValue per a text de visualització; utilitzar Cell.Value quan necessites l’objecte .NET brut.
• Crear conjunts de regles de formatatge condicional en el rang més ampli que necessites les regnes per filas són cares en fitxes grans.
• L’anomenaràs. wb.Save() una vegada al final, en comptes d’escriure després de cada cèl·lula.

Problemàtiques comuns

FAQ

Aspose.Cells FOSS per a .NET requereix Microsoft Office?

No. La biblioteca és codi purament gestionat sense dependència d’Office, Excel o COM interop.

Quins formats de fitxer són compatibles?

XLSX (llegir i escriure). CSV, ODS, PDF i binaris XSL no són compatibles en aquesta versió.

Puc utilitzar aquesta biblioteca en una aplicació comercial?

Sí. Aspose.Cells FOSS és publicat sota la llicència MIT, que permet l’ús comercial sense restriccions i sense drets d’autor.

Quina és la versió mínima de .NET?

.NET 6.0 o més tard.

Com puc aplicar un color de fons a una cèl·lula?

Set de punts style.Pattern = FillPattern.Solid i de la style.ForegroundColor = Color.FromArgb(...), llavors trucar cell.SetStyle(style).

Resum de referència d’API