Ievads

Aspose.Cells FOSS for .NET ir tīri pārvaldīta koda, MIT licences bibliotēka, kas ļauj lasīt, rakstīt, un manipulēt ar Excel .xlsx darblapām bez jebkādas Microsoft Office atkarības. Instalēta kā Aspose.Cells_FOSS NuGet pakotne, tā integrējas jebkurā .NET projektā — konsoles lietojumprogrammas, tīmekļa API, fona darbinieki, un serverless funkcijas.

Šis ieraksts sniedz soli pa solim pārskatu par publisko API, parādot, kas ir iespējams, un kā izsaukt katru iespēju no C# koda.

Īpašību pārskats

Darblapas un darblapas lapas dzīves cikls

Katras operācijas ieejas punkts ir Workbook klase. Izveidojiet to no nulles ar new Workbook(), vai ielādējiet esošu .xlsx ar new Workbook(filePath) vai new Workbook(stream). Navigējiet pa lapām, izmantojot Workbook.Worksheets, iestatiet Worksheet.Name un Worksheet.VisibilityType, un saglabājiet ar Workbook.Save(). Bojātu failu gadījumā nododiet LoadOptions instance ar TryRepairPackage = true un 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);
}

Šūnu dati un formulas

Rakstiet vērtības šūnās, izmantojot Cell.PutValue() — pārlādējumi pieņem string, int, double, decimal, bool un DateTime. Lasiet vērtības atpakaļ, izmantojot Cell.Value, Cell.StringValue un Cell.Formula. Iestatiet Excel formulas, izmantojot Cell.Formula īpašību; formulas virkne tiek saglabāta saglabāšanas laikā un izdzīvo pārlādēšanas ciklu.

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

Šūnas stilizēšana

Lietojiet Style objektus, lai kontrolētu fontu, aizpildījumu, robežas, skaitļu formātu un izlīdzinājumu.
Iegūstiet pašreizējo stilu ar Cell.GetStyle(), modificējiet to, pēc tam apstipriniet ar
Cell.SetStyle(). Lai iestatītu fona aizpildījumus, iestatiet Style.Pattern = FillPattern.Solid un piešķiriet
Color uz Style.ForegroundColor. Izmantojiet Cells.Merge(), lai aptvertu šūnu diapazonus.

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

Nosacītā formatēšana

Pievienojiet nosacītās formatēšanas noteikumus šūnu diapazoniem, izmantojot ConditionalFormattingCollection.
Noteikumi atbalsta FormatConditionType.CellValue, Expression, ColorScale, DataBar, un
IconSet. Izmantojiet OperatorType, lai norādītu salīdzināšanas operatorus (Between, Equal,
GreaterThan, utt.), piešķiriet Style atbilstošajām šūnām, un konfigurējiet prioritāti un
stop‑if‑true uzvedību katram noteikumam.

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

Datu validācija

Pievienojiet ievades ierobežojumus šūnām, izmantojot Worksheet.Validations. Atbalstītie validācijas veidi iekļauj ValidationType.List, Decimal, Custom, un citus. Konfigurējiet ievades uzvednes (InputTitle, InputMessage) un kļūdu ziņojumus (ErrorTitle, ErrorMessage, ValidationAlertType). Izmantojiet CellArea.CreateCellArea(), lai definētu validēto diapazonu un Validation.AddArea(), lai piemērotu noteikumu papildu diapazoniem.

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

Lapas iestatījumi un drukāšanas iespējas

Konfigurējiet drukas izkārtojumu, izmantojot Worksheet.PageSetup. Iestatiet robežas (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, mērogu, drukas apgabalu, virsrakstu rindas un kolonnas, galvenes un kājenes, kā arī lapas pārtraukumus. Visi iestatījumi izdzīvo saglabāšanas‑ielādes ciklu.

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

Darblapas iestatījumi un aizsardzība

Kontrolējiet katras lapas attēlojumu ar Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom, un TabColor. Aizsargājiet lapas ar Worksheet.Protect() un konfigurējiet smalkas Protection karogus (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells). Pārvaldiet rindu augstumu, kolonnas platumu, slēptas rindas/kolonnas, un apvienotās teritorijas, izmantojot Cells.Rows, Cells.Columns, un 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");

Hipersaites un nosauktie diapazoni

Pievienojiet ārējās, iekšējās un mailto: hipersaites, izmantojot HyperlinkCollection.Add(). Iestatiet Hyperlink.TextToDisplay un Hyperlink.ScreenTip lietotājam redzamām etiķetēm. Definējiet nosauktus diapazonus darba grāmatā vai loksnē, izmantojot DefinedNameCollection.Add() — nosauktie diapazoni kalpo kā stabilas formulas enkuri un diagrammu datu avoti, kas izdzīvo faila pārlādēšanu.

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

Ātrais sākums

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

Atbalstītie formāti

FormātsPaplašinājumsLasītRakstīt
Xlsx.xlsx✓✓
Auto(dažādi)✓—

Atvērtā pirmkods un licencēšana

Aspose.Cells FOSS for .NET ir publicēts zem MIT licences un izplatīts caur NuGet kā
Aspose.Cells_FOSS. Tas ir piemērots gan atvērtā koda, gan komerciāliem projektiem.

Sākšana

Saistītie resursi