Charakteristika:

Charakteristika:

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 Tato stránka shrnuje všechny hlavní oblasti funkcí s krátkými příklady kódu.

Pracovní kniha Vytvořte, naložte a ukládejte

Vytvořit novou pracovní knihu pomocí: new Workbook(). Nahrát existující XLSX soubor přenášením cesty k konstruktoru. Použijte LoadOptions Zařízení pro zajištění bezchybného zatížení. Workbook.Save(path) Přetrvávající změny.

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 buňkách a vzorce

Použití: Cell.PutValue() psát řetězce, celá čísla, desítky, booleans a DateTime Hodnoty. Nastavení Cell.Formula k přiřazení řetězce vzorec kompatibilní s Excelem. Přečti zpět text zobrazovacího systému prostřednictvím Cell.StringValue a surová hodnota prostřednictvím 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

Stylování buněk

Získejte a upravte soubor . Style objekt pro každou buňku s: Cell.GetStyle() a) Cell.SetStyle().- To je ono . Style třída poskytuje: Font (tvrdá, kurzivní písmeno, velikost, název), ForegroundColor, Pattern (přístrojů: FillPattern), HorizontalAlignment (použití: HorizontalAlignmentType), a hraniční kontroly prostřednictvím 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");

Podmínkové formátování

Worksheet.ConditionalFormattings vrací a ConditionalFormattingCollection.Zavolej . Add() vytvořit soubor pravidel, pak AddCondition() Přidat pravidla pomocí: FormatConditionType a) OperatorType.Typy podporovaných podmínek zahrnují: 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");

Ověřování údajů

Worksheet.Validations vrací a ValidationCollection.Zavolej . Add(CellArea) vytvořit Validation pro rozsah buňky. Type majetek s využitím ValidationType (List, Decimal,nebo: Custom) Nastavení 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 odhaluje AutoFilter Objekt. Nastavení AutoFilter.Range Pro definici rozmezí řádku náčelníku. Access AutoFilter.FilterColumns (sbírka) a volání Add(columnIndex) aktivovat filtrování v konkrétním sloupci.

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 HyperlinkCollection.Zavolej . Add() Vkládat externí URL, interní odkazy buněk nebo mailto-linky. Set Hyperlink.TextToDisplay a) Hyperlink.ScreenTip pro text určený uživateli. Workbook.DefinedNames je DefinedNameCollection; volání Add(name, refersTo) vytvořit jmenované rozsahy.

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

Nastavení stránek

Worksheet.PageSetup ovládá okraje tisku, orientaci, velikost papíru, plochu tiska, řádky/součítky titulů, nadpisy, podpalubí a rozbitiny stránek. Použijte PageOrientationType a) PaperSizeType - Ne, ne. - Ano, ano.

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

Přidání, přejmenování, schovávání a přeřazení pracovních listů prostřednictvím WorksheetCollection. WorksheetCollection.Add(name) Vrátí index nového listu. Set Worksheet.VisibilityType Použití: VisibilityType.Spojit buňky s Cells.Merge() a rozměry řádků/souhelníků ovládání prostřednictvím 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 nejlepší postupy

• Vždy chytit. WorkbookLoadException při načítání souborů z cest poskytnutých uživatelem.
• Použití: Cell.PutValue() s přesným typem .NET, který chcete uložit pass decimal pro měnu, DateTime na rande.
• Čtěte. Cell.StringValue pro zobrazovací text; použití Cell.Value když potřebujete surový objekt .NET.
• Vytvořte soubory podmíněných pravidel formátování v nejširším rozmezí, které potřebujete Pravidla na řádek jsou drahé ve velkých listech.
• Zavolej . wb.Save() jednou na konci, spíše než po každé buňce.

Obvyklé problémy

FAQ

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

Ne, knihovna je čistě spravovaný kód bez závislosti na Officeu, Exceli nebo COM interop.

Jaké soubory jsou podporovány?

XLSX (čtení a psaní). CSV, ODS, PDF a binární XSL nejsou podporovány v tomto vydání.

Můžu tuto knihovnu použít v komerční aplikaci?

Ano, Aspose.Cells FOSS je vydán pod licencí MIT, která umožňuje neobmedzené komerční použití bez poplatků za autorské práva.

Jaká je minimální verze .NET?

.NET 6.0 nebo novější.

Jak na buňku nanést barvu pozadí?

Sestavení: style.Pattern = FillPattern.Solid a) style.ForegroundColor = Color.FromArgb(...), tak zavolej . cell.SetStyle(style).

Souhrnná referenční informace API