Introduksjon

Aspose.Cells FOSS for .NET er et rent administrert kode, MIT‑lisensiert bibliotek for lesing, skriving, og manipulering av Excel .xlsx arbeidsbøker uten noen Microsoft Office‑avhengighet. Installert som Aspose.Cells_FOSS NuGet‑pakken, integreres den i ethvert .NET‑prosjekt — konsollapper, web APIer, bakgrunnsarbeidere og serverløse funksjoner.

Dette innlegget gir en funksjon‑for‑funksjon gjennomgang av det offentlige API‑et, og viser hva som er mulig og hvordan man aktiverer hver funksjon fra C#‑kode.

Funksjonsoversikt

Arbeidsbok og regneark livssyklus

Inngangspunktet for hver operasjon er Workbook-klassen. Konstruer en fra bunnen med new Workbook(), eller last inn en eksisterende .xlsx med new Workbook(filePath) eller new Workbook(stream). Naviger ark via Workbook.Worksheets, sett Worksheet.Name og Worksheet.VisibilityType, og lagre med Workbook.Save(). For skadede filer, send inn en LoadOptions-instans 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 verdier til celler med Cell.PutValue() — overbelastninger godtar string, int, double, decimal, bool og DateTime. Les verdier tilbake via Cell.Value, Cell.StringValue og Cell.Formula. Sett Excel‑formler med Cell.Formula‑egenskapen; formelstrengen bevares ved lagring og overlever en lastesyklus.

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

Celleformatering

Bruk Style-objekter for å kontrollere skrifttype, fyll, kantlinjer, tallformat og justering.
Hent den nåværende stilen med Cell.GetStyle(), endre den, og deretter forplikte med
Cell.SetStyle(). For bakgrunnsfyll, sett Style.Pattern = FillPattern.Solid og tildel en
Color til Style.ForegroundColor. Bruk Cells.Merge() for å spenne over celleområder.

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

Betinget formatering

Legg ved betingede formateringsregler til celleområder via ConditionalFormattingCollection.
Regler støtter FormatConditionType.CellValue, Expression, ColorScale, DataBar, og
IconSet. Bruk OperatorType for å angi sammenligningsoperatorer (Between, Equal,
GreaterThan, osv.), tilordne en Style til samsvarende celler, og konfigurer prioritet og
stop-if-true‑oppførsel per 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

Legg til inndatarestriksjoner i celler ved hjelp av Worksheet.Validations. Støttede valideringstyper inkluderer ValidationType.List, Decimal, Custom, og flere. Konfigurer inndataprompter (InputTitle, InputMessage) og feilmeldinger (ErrorTitle, ErrorMessage, ValidationAlertType). Bruk CellArea.CreateCellArea() for å definere det validerte området og Validation.AddArea() for å anvende en regel på ytterligere områder.

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

Sideoppsett og utskriftsalternativer

Konfigurer utskriftslayout via Worksheet.PageSetup. Angi marger (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, skala, utskriftsområde, tittelrader og -kolonner, topptekster og bunntekster, og sideskift. Alle innstillinger overlever en lagre-last runde.

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

Arbeidsarkinnstillinger og beskyttelse

Kontroller per‑ark‑visning med Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom og TabColor. Beskytt ark med Worksheet.Protect() og konfigurer fininnstilte Protection‑flagg (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells). Administrer radhøyde, kolonnebredde, skjulte rader/kolonner, og sammenslåtte områder 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");

Hyperkoblinger og navngitte områder

Legg til eksterne, interne og mailto: hyperkoblinger via HyperlinkCollection.Add(). Angi Hyperlink.TextToDisplay og Hyperlink.ScreenTip for bruker‑synlige etiketter. Definer navngitte områder på arbeidsbok‑ eller ark‑nivå ved hjelp av DefinedNameCollection.Add() — navngitte områder fungerer som stabile formelankere og diagramdatakilder som overlever filinnlasting.

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

Rask 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

FormatExtensionLesSkriv
Xlsx.xlsx✓✓
Auto(various)✓—

Open Source og lisensiering

Aspose.Cells FOSS for .NET er publisert under MIT‑lisensen og distribuert via NuGet som
Aspose.Cells_FOSS. Den er egnet for både åpen kildekode og kommersielle prosjekter.

Kom i gang

Relaterte ressurser