Charakteristiky

Charakteristiky

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 Táto stránka súhrňuje každú hlavnú oblasť funkcií s krátkymi príkladmi kódu.

Pracovník Vytvorte, naložte a ukladajte

Vytvorenie nového zošity s použitím: new Workbook(). Nahráňte existujúci súbor XLSX prechodom cesty k konštruktoru. Použite LoadOptions na umožnenie zaťaženia s toleranciou voči poruchám. Workbook.Save(path) pretrvávajúcu zmenu.

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

Údaje o bunkách a vzorce

Použitie: Cell.PutValue() na písanie reťazcov, celých čísel, desatinných bodov, booleanských a DateTime Vyrovnanie hodnôt. Cell.Formula Pridať šablónu vzorca kompatibilný s Excelom. Prečítať späť text zobrazenia prostredníctvom Cell.StringValue a surová hodnota prostredníctvom: 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

Stylovanie buniek

Získať a upraviť Style objekt pre každú bunku s: Cell.GetStyle() a) Cell.SetStyle().- To je … Style trieda poskytuje: Font (tvrdá, kurzivka, veľkosť, meno), ForegroundColor, Pattern (typ: FillPattern), HorizontalAlignment (používa sa: HorizontalAlignmentType), a hraničná kontrola prostredníctvom 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");

Podmiene formátovania

Worksheet.ConditionalFormattings vráti a ConditionalFormattingCollection.Zavolaj . Add() vytvoriť súbor pravidiel, potom AddCondition() Pridať pravidlá pomocou: FormatConditionType a) OperatorType.Typy podporovaných podmienok zahŕňajú: CellValue, Expression, ColorScale, DataBar,a) 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");

Validácia údajov

Worksheet.Validations vráti a ValidationCollection.Zavolaj . Add(CellArea) vytvoriť Validation pre rozsah bunky. Type majetok využívajúci ValidationType (List, Decimal,alebo Custom) Nastavenie: Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle,a) 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");

Automatický filtr

Worksheet.AutoFilter odhaľuje AutoFilter Objekt. Nastavenie AutoFilter.Range na definovanie rozsahu riadkov nadpisu. Access AutoFilter.FilterColumns (zber) a vyzývajú Add(columnIndex) Ak je to možné, použijte položku “Filtrovanie” v tomto bode.

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

Hypertextové odkazy a definované názvy

Worksheet.Hyperlinks je a HyperlinkCollection.Zavolaj . Add() na vkladanie externých URL, vnútorných odkazov na bunky alebo odkazy mailto. Nastaviť Hyperlink.TextToDisplay a) Hyperlink.ScreenTip pre text určený používateľovi. Workbook.DefinedNames je a DefinedNameCollection; zavolajte Add(name, refersTo) vytvoriť pomenované rozpätia.

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

Nastavenie stránky

Worksheet.PageSetup ovláda tlačové okrajovky, orientáciu, veľkosť papiera, tlačiarenskú plochu, riadky/spojky názvu, nadpisy, podpísané strany a rozbitiny stránok. Používajte PageOrientationType a) PaperSizeType - Áno.

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

Správa pracovného listu

Pridať, premenovať, skryť a preurčiť hárky pomocou WorksheetCollection. WorksheetCollection.Add(name) Vráti index nového hárka. Nastavenie Worksheet.VisibilityType Používanie: VisibilityType.Zlúčenie buniek s Cells.Merge() a riadenie veľkosti riadkov/stolcov prostredníctvom: Cells.Rows a) 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");

Tipy a najlepšie postupy

• Vždy chytím . WorkbookLoadException pri načítaní súborov z cestu, ktorý poskytol používateľ.
• Použitie: Cell.PutValue() s presným typom .NET , ktorý chcete uložiť pass decimal pre menu, DateTime na rande.
• Čítajte si . Cell.StringValue pre zobrazovací text; použitie Cell.Value keď potrebujete surový objekt .NET.
• Vytvorte nastavenia podmienok formátovania v najširšom rozsahu, ktorý potrebujete Pravidlá na riadok sú drahé vo veľkých hárkoch.
• Zavolajte . wb.Save() raz na konci, nie po každej bunky napísať.

Spoločné problémy

FAQ

Vyžaduje Aspose.Cells FOSS pre .NET Microsoft Office?

Nie, knižnica je čistý spravovaný kód bez závislosti na Office, Excel alebo COM interop.

Aké súbory sú podporované?

XLSX (čítanie a písanie). CSV, ODS, PDF a binárne XSL nie sú podporované v tomto vydaní.

Môžem použiť túto knižnicu v komerčnej aplikácii?

Áno, Aspose.Cells FOSS je publikovaný pod licenciou MIT, ktorá umožňuje neobmedzené komerčné použitie bez poplatkov za autorské práva.

Aká je minimálna verzia .NET?

.NET 6.0 alebo novší.

Ako na celu nanesiem farbu pozadia?

Sadzba style.Pattern = FillPattern.Solid a) style.ForegroundColor = Color.FromArgb(...), potom zavolaj . cell.SetStyle(style).

Zhrnutie referenčného API