Johdanto

Aspose.Cells FOSS for .NET on puhdas hallinnoitu koodi, MIT‑lisensoitu kirjasto lukemiseen, kirjoittamiseen, ja Excel .xlsx -työkirjojen muokkaamiseen ilman Microsoft Office -riippuvuutta. Asennettuna Aspose.Cells_FOSS NuGet-pakettina se integroidaan mihin tahansa .NET-projektiin — konsolisovelluksiin, web API:hin, taustatyöntekijöihin ja serverittomiin toimintoihin.

Tämä julkaisu tarjoaa ominaisuus kerrallaan -läpikäynnin julkisesta API:sta, näyttäen, mitä on mahdollista ja miten kutsua kutakin ominaisuutta C#-koodista.

Ominaisuuksien yleiskatsaus

Työkirjan ja Työarkin elinkaari

Jokaisen toiminnon sisäänkäynti on Workbook-luokka. Rakenna yksi alusta alkaen new Workbook():lla, tai lataa olemassa oleva .xlsx new Workbook(filePath):lla tai new Workbook(stream):lla. Selaa taulukoita Workbook.Worksheets:n avulla, aseta Worksheet.Name ja Worksheet.VisibilityType, ja tallenna Workbook.Save():lla. Vaurioituneille tiedostoille anna LoadOptions-instanssi TryRepairPackage = true ja TryRepairXml = true kanssa.

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

Solun tiedot ja kaavat

Kirjoita arvot soluihin Cell.PutValue() — ylikuormitukset hyväksyvät string, int, double, decimal, bool ja DateTime. Lue arvot takaisin Cell.Value, Cell.StringValue ja Cell.Formula. Aseta Excel-kaavat Cell.Formula-ominaisuudella; kaavamerkkijono säilyy tallennettaessa ja kestää uudelleenlataussyklin.

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

Solun muotoilu

Käytä Style-objekteja hallitsemaan fonttia, täyttöä, reunuksia, numeroformaattia ja tasausta. Hae nykyinen tyyli Cell.GetStyle()-komennolla, muokkaa sitä, ja tallenna sitten Cell.SetStyle()-komennolla. Taustatäytteitä varten aseta Style.Pattern = FillPattern.Solid ja määritä Color Style.ForegroundColor:lle. Käytä Cells.Merge() laajentaaksesi solualuetta.

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

Ehdollinen muotoilu

Liitä ehdollisen muotoilun säännöt solualueisiin via ConditionalFormattingCollection. Säännöt tukevat FormatConditionType.CellValue, Expression, ColorScale, DataBar, ja IconSet. Käytä OperatorType määrittääksesi vertailuoperaattorit (Between, Equal, GreaterThan, jne.), määritä Style vastaaville soluille ja määritä prioriteetti sekä stop-if-true‑käyttäytyminen per sääntö.

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

Datan validointi

Lisää syöte‑rajoituksia soluihin käyttämällä Worksheet.Validations. Tuetut validointityypit sisältävät ValidationType.List, Decimal, Custom ja muita. Määritä syötekehotteet (InputTitle, InputMessage) ja virheilmoitukset (ErrorTitle, ErrorMessage, ValidationAlertType). Käytä CellArea.CreateCellArea() määrittääksesi validoidun alueen ja Validation.AddArea() soveltaaksesi sääntöä lisäalueisiin.

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

Sivun asetukset ja tulostusasetukset

Määritä tulostusasettelu via Worksheet.PageSetup. Aseta marginaalit (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, skaala, tulostusalue, otsikkorivit ja -sarakkeet, ylätunnisteet ja alatunnisteet sekä sivunvaihdot. Kaikki asetukset säilyvät tallennus‑lataus -kierroksessa.

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

Taulukon asetukset ja suojaus

Hallitse taulukko-kohtaista näyttöä Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom ja TabColor. Suojaa taulukot Worksheet.Protect() ja määritä hienojakoiset Protection‑liput (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells). Hallitse rivikorkeutta, sarakeleveyttä, piilotettuja rivejä/sarakkeita ja yhdistettyjä alueita Cells.Rows, Cells.Columns ja 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");

Hyperlinkit ja nimetyt alueet

Lisää ulkoisia, sisäisiä ja mailto: hyperlinkkejä HyperlinkCollection.Add() avulla. Aseta
Hyperlink.TextToDisplay ja Hyperlink.ScreenTip käyttäjälle näkyviin nimiöihin. Määritä nimettyjä
alueita työkirjan tai taulukon tasolla käyttäen DefinedNameCollection.Add() — nimettyjä alueita toimivat
vakaina kaavaankkureina ja kaavion tietolähteinä, jotka säilyvät tiedoston uudelleenlatauksessa.

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

Pika-aloitus

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

Tuetut tiedostomuodot

MuotoTiedostopääteLukuKirjoitus
Xlsx.xlsx✓✓
Automaattinen(erilaisia)✓—

Avoin lähdekoodi ja lisensointi

Aspose.Cells FOSS for .NET julkaistaan MIT‑lisenssin alla ja jaetaan NuGetin kautta Aspose.Cells_FOSS. Se soveltuu sekä avoimen lähdekoodin että kaupallisiin projekteihin.

Aloittaminen

Liittyvät resurssit