Beskrivelse:

Beskrivelse:

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 Denne side opsummerer alle de vigtigste funktioner med korte kodeksempler.

Arbejdskort Oprette, indlæse og gemme

Oprette en ny arbejdsbog med new Workbook().Lade en eksisterende XLSX fil ved at give den konstruktor en filevej. Brug LoadOptions for at muliggøre fejl tolerant belastning. Workbook.Save(path) at fortsætte med ændringer.

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

Celledata og formler

Anvendelse: Cell.PutValue() at skrive strenge, heltal, desimaler, boolean-tal og DateTime Valuer. Cell.Formula til at tildele en Excel-kompatibel formelstreng. Læs tilbage visningsteksten via Cell.StringValue og råværdien via 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

Celleformning

Tilbagevinde og ændre den Style objekt for enhver celle med: Cell.GetStyle() og: Cell.SetStyle().- Det er … Style klasse giver Font (fuldt, kursiv, størrelse, navn), ForegroundColor, Pattern (af type: FillPattern), HorizontalAlignment (ved hjælp af: HorizontalAlignmentType), og grænsekontrol gennem EU-forbindelserne med tredjelande. 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");

Betingede formateringer

Worksheet.ConditionalFormattings returnerer en ConditionalFormattingCollection.Ring til mig. Add() at skabe et regelsæt, så AddCondition() at tilføje regler ved hjælp af FormatConditionType og: OperatorType.Støttede tilstandstyper omfatter: CellValue, Expression, ColorScale, DataBar, og 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");

Datavalidering

Worksheet.Validations returnerer en ValidationCollection.Ring til mig. Add(CellArea) at skabe en Validation For at få et cell-interval, skal du indstille Type ejendom ved hjælp af ValidationType (List, Decimal,eller: Custom) Konfigurer Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle, og 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");

Automatisk filter

Worksheet.AutoFilter Det er en stor udfordring. AutoFilter Objekt. AutoFilter.Range at definere overskriftsradebygningen. Access AutoFilter.FilterColumns (en samling) og opkald til Add(columnIndex) at aktivere filtrering på en bestemt kolonne.

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

Hyperlinks og definerede navne

Worksheet.Hyperlinks er en HyperlinkCollection.Ring til mig. Add() at indsætte eksterne URL’er, interne cellereferencer eller mailto-links. Sæt Hyperlink.TextToDisplay og: Hyperlink.ScreenTip for brugerorienteret tekst. Workbook.DefinedNames er en DefinedNameCollection; ring til Add(name, refersTo) at oprette navngivne intervaller.

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

Siderindstilling

Worksheet.PageSetup Kontroller trykmargener, orientering, papirstørrelse, trykområde, titler/kolonner, overskrifter og sidebreak. Brug PageOrientationType og: PaperSizeType - Det er en masse.

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

Arbejdsskemaforvaltning

Tilføj, omdøb, skjul og ordn arbejdssider gennem WorksheetCollection. WorksheetCollection.Add(name) Returnerer indekset for det nye ark. Sæt Worksheet.VisibilityType brug af VisibilityType.Fusion af celler med Cells.Merge() og kontrolrække/kolonne-størrelse via Cells.Rows og: 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");

Tips og bedste praksis

• • Altid at fange. WorkbookLoadException ved indlæse af filer fra brugerindgivne stier.
• Anvendelse: Cell.PutValue() med den nøjagtige .NET-type, du vil gemme pass decimal for valuta, DateTime - For at date.
• Læs det. Cell.StringValue for visning af tekst; brug Cell.Value når du har brug for den rå .NET objekt.
• Oprette betingede formateringsregelsæt på det bredeste område, du har brug for Regler per række er dyre i store ark.
• Ring til mig. wb.Save() En gang i slutningen snarere end efter hver celle skrive.

Almindelige problemer

FAQ

Er det nødvendigt at bruge Microsoft Office i Aspose.Cells FOSS for .NET?

Biblioteket er ren administreret kode uden afhængighed af Office, Excel eller COM-interop.

Hvilke filformater understøttes?

CSV, ODS, PDF og binære XLS understøttes ikke i denne udgave.

Kan jeg bruge biblioteket i en kommerciel applikation?

Ja, Aspose.Cells FOSS er udgivet under MIT-licensen, som tillader ubegrænset kommerciel brug uden royalties.

Hvad er den mindste .NET-version?

.NET 6.0 eller nyere.

Hvordan anvender jeg en baggrundskolor på en celle?

Indstilling style.Pattern = FillPattern.Solid og: style.ForegroundColor = Color.FromArgb(...),Så ring. cell.SetStyle(style).

API-referenceoversigt