A tulajdonságok

A tulajdonságok

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 Az alábbi oldal minden fő funkció területét rövid kód példákkal foglalja össze.

Munkafüzet Tervezés, betöltés és mentés

Új munkafüzet létrehozása a következőkkel: new Workbook().A programot a következőkben kell elhelyezni: . Töltse egy meglévő XLSX fájlt, azáltal hogy átadja a fájl útját a konstruktornak. Használja LoadOptions A rendszer a következőképpen működik: Workbook.Save(path) a változások kitartása.

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

Cellaadatok és képletek

Használat Cell.PutValue() a szavak, számok és számjegyek leírására. DateTime értékek. Cell.Formula az Excel-kompatibilis képlet szalagszámból. Olvasd vissza a megjelenítési szöveget az alábbi formanyomtatványon keresztül: Cell.StringValue és a nyers érték az alábbi formában: 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

Cella stílusosítás

A programot visszaszerzi és módosítja. Style objektum bármely cellára, amelynek a Cell.GetStyle() és a következők: Cell.SetStyle().A… a… Style osztály nyújtja a Font (kövér, kursiv, méret, név), ForegroundColor, Pattern (a típusból) FillPattern), HorizontalAlignment (a következők használatával: HorizontalAlignmentType), valamint a határellenőrzés az EU-n keresztül. 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");

Feltételezett formázás

Worksheet.ConditionalFormattings az a-t adja vissza. ConditionalFormattingCollection.Hívj fel. Add() hogy létrehozzunk egy szabályt, akkor AddCondition() szabályok hozzáadása FormatConditionType és a OperatorType.A támogatott állapottípusok a következők: CellValue, Expression, ColorScale, DataBar, és 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");

Adatértékelés

Worksheet.Validations visszaadja a ValidationCollection.- Hívj! Add(CellArea) létrehozása Validation a cellák hatótávolságára. Type ingatlan felhasználásával ValidationType (List, Decimal, vagy Custom) Beállítása Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle, és 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");

Automata szűrő

Worksheet.AutoFilter a szén-dioxid AutoFilter Csomag. AutoFilter.Range A címsorok sortartományának meghatározására. Access AutoFilter.FilterColumns (gyűjtemény) és felhívás Add(columnIndex) egy adott oszlopon történő szűrés aktiválása.

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

Hyperlinkek és meghatározott nevek

Worksheet.Hyperlinks az a HyperlinkCollection.- Hívj! Add() a külső URL-ek, a belső cellák hivatkozásai vagy a mailto-linkek beillesztése. Hyperlink.TextToDisplay és a Hyperlink.ScreenTip a felhasználóval szembeni szöveghez. Workbook.DefinedNames a) az alábbiak: DefinedNameCollection; hívás Add(name, refersTo) a megnevezett tartományok létrehozására.

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

Oldalak beállítását

Worksheet.PageSetup a nyomtatási hatókörök, az irányítás, a papírméret, kiadásterület, címsor/oszlopok, fejléc, lábjegy és lapszünetek ellenőrzése. PageOrientationType és a következők: PaperSizeType - Nem, nem.

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

Munkalapkezelés

Adja hozzá, nevezze át, rejtse el és rendezze újra a munkalapokat az alábbiakban: WorksheetCollection. WorksheetCollection.Add(name) Az új lap indexjét adja. Set Worksheet.VisibilityType felhasználás VisibilityType.A cellák egyesítése a következőkkel: Cells.Merge() és a sor/oszlop méretének ellenőrzése az alábbi módon: Cells.Rows és a következők: 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");

Tippek és legjobb gyakorlatok

• Mindig kapsz. WorkbookLoadException a felhasználó által megadott útvonalakból történő fájl betöltésekor.
• Használat Cell.PutValue() a pass tárolni kívánt .NET típuskal. decimal a pénznemben, DateTime Randizni.
• Olvasd! Cell.StringValue megjelenítő szöveg; használata Cell.Value amikor a nyers .NET objektumra van szükséged.
• Tervezett formázási szabálykészleteket hozzon létre a legszélesebb körben, amire szüksége van A soronkénti szabályok drágák nagy lapokban.
• Hívj! wb.Save() egyszer a végén, nem pedig minden cellát ír.

Általános kérdések

FAQ

A .NET-hez szükséges Aspose.Cells FOSS a Microsoft Office?

Nem, a könyvtár tiszta kezelhető kód, nem függ az Office-tól, Excel-től vagy COM interop-ról.

Milyen fájlformátumokat támogatnak?

XLSX (olvasás és írás). CSV, ODS, PDF és bináris XSL nem támogatott ebben a kiadásban.

Használhatom ezt a könyvtárat kereskedelmi célra?

Igen, az Aspose.Cells FOSS a MIT Licenc alatt kerül kiadásra, ami korlátozatlan kereskedelmi használatot engedélyez szabadon és nem fizet honlapdíjat.

Mi a minimális .NET változat?

.NET 6.0 vagy újabb.

Hogyan alkalmazhatok egy cellára háttérszínt?

Összeállítva style.Pattern = FillPattern.Solid és a következők: style.ForegroundColor = Color.FromArgb(...), akkor hívj! cell.SetStyle(style).

API-referencia összefoglaló