Indledning

Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, og håndtering af Excel. .xlsx Arbejdsmapper uden nogen Microsoft Office-afhængighed. Installeret som Den 1. januar. Aspose.Cells_FOSS NuGet-pakken integrerer sig i ethvert .NET projekt konsolprogrammer, web API’er, baggrundsarbejdere og serverløse funktioner.

Dette indlæg giver en walkthrough af den offentlige API, der viser hvad er muligt og hvordan man kan opfordre hver evne fra C # -kode.

Oversigt over funktioner

Arbejdsbogen og arbejdsskemaet Livscyklus

Indgangspunktet for hver operation er den Workbook Man kan bygge en fra bunden med et nyt system. new Workbook(), eller indlæse en eksisterende .xlsx med: new Workbook(filePath) eller en anden new Workbook(stream).Navigation af ark via: Workbook.Worksheets, sæt Worksheet.Name og: Worksheet.VisibilityType, og vedholdende med Workbook.Save().For beskadigede filer, skal du sende en e-mail til: LoadOptions Eksempelvis med TryRepairPackage = true og: 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);
}

Celledata og formler

Skriv værdier til celler med: Cell.PutValue() overbelastning accepteres string, int, double, decimal, bool, og DateTime.Læs værdierne tilbage via Cell.Value, Cell.StringValue, og Cell.Formula.Indstil Excel-formler med Cell.Formula ejendommen; formelstrengen er: bevares på save og overlever en genladningskurs.

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

Celleformning

Ansøgning Style objekter til styring af skrifttype, fyldning, grænser, nummerformat og justering. Få den aktuelle stil med: Cell.GetStyle(), mutere det, så begå med Cell.SetStyle().For baggrundsskiftning, indstillet Style.Pattern = FillPattern.Solid og tildele en Color til Style.ForegroundColor.- Brug det. Cells.Merge() til at udvide celletraje.

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

Betingede formateringer

Vedhæfte betingede formateringsregler til celleintervaller via ConditionalFormattingCollection. Reglernes støtte FormatConditionType.CellValue, Expression, ColorScale, DataBar, og IconSet.- Brug det. OperatorType at angive sammenligningsoperatører (Between, Equal, GreaterThan, osv.), tildele en Style til matcherede celler og konfigurere prioritet og Stop-if-true adfærd pr. regel.

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

Datavalidering

Tilføj indgangsrestriktioner til celler ved hjælp af Worksheet.Validations.Støttede valideringstyper omfatter: ValidationType.List, Decimal, Custom, og mere. Konfigurer input-opfordringer (InputTitle, InputMessage) og fejlmeddelelser (ErrorTitle, ErrorMessage, ValidationAlertType) Anvendelse CellArea.CreateCellArea() at definere det validerede interval og Validation.AddArea() at anvende en regel på yderligere intervaller.

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

Optimering af sider og udskrivning

Konfigurer trykindstillinger via Worksheet.PageSetup.Sæt margener (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, skala, Udskrivningsareal, titlerække og -kolonner, overskrifter og fodnote samt sidebreak. Alle indstillinger forbliver ved at blive oprettet i et andet format end det oprindelige. en rundrejse med besparelse.

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

Arbejdsskemaindstillinger og beskyttelse

Kontrol per ark med Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom, og TabColor.Beskytte ark med: Worksheet.Protect() og konfigurere finkornet Protection flag (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells) Forvalte rækkehøjde, kolonnebredde og skjulte rækker/kolonner samt Fusioner via: Cells.Rows, Cells.Columns, og 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");

Tilføj ekstern, intern og mailto: hyperlinks via: HyperlinkCollection.Add().- Sæt. Hyperlink.TextToDisplay og: Hyperlink.ScreenTip For bruger synlige mærker definer navngivet intervaller i arbejdsmålebogen eller arkets omfang ved hjælp af DefinedNameCollection.Add() navngivne intervaller fungerer som stabil formelankre og diagramdatakilder, der overlever filgenlæsning.

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

Hurtig start

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

Støttede formater

Format:UdvidelseLæs det.Skriv ned
Xlsx.xlsx✓✓
Auto-bil(værelige)✓—

Open Source & Licensing

Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as Aspose.Cells_FOSS.Den er egnet til både open source- og kommercielle projekter.

Hvordan man begynder