egenskaper

egenskaper

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 klass, som ger tillgång till arbetsblad, definierade namn och spara/ladda operationer. Denna sida sammanfattar varje viktig funktionområde med korta kodexempel.

Arbetsbok Skapa, Ladda och Spara

Skapa en ny arbetsbok med new Workbook().Ladda upp en befintlig XLSX-fil genom att passera en filvägen till konstruktören. LoadOptions för att möjliggöra feltolerant laddning. ringa Workbook.Save(path) för att fortsätta förändringar.

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

Celldata och formler

Användning Cell.PutValue() att skriva strängar, integer, decimaler, boolean och DateTime Värden - Set Cell.Formula att tilldela en Excel-kompatibel formel sträng. Läs tillbaka text som visas via Cell.StringValue och råvärdet genom Cell.Value.

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

---

### Cell Styling

Reträva och ändra den `Style` objekt för varje cell med `Cell.GetStyle()` och `Cell.SetStyle()`. den `Style` Klasserna ger `Font` (Bold, italiensk, storlek och namn), `ForegroundColor`, `Pattern` (för typ av `FillPattern`), `HorizontalAlignment` (användning av `HorizontalAlignmentType`och gränskontroll genom `Borders`.

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

Villkorlig formatering

Worksheet.ConditionalFormattings Återkommer A ConditionalFormattingCollection.- ringa Add() att skapa en regel, och sedan AddCondition() Lägg till regler för användning FormatConditionType och OperatorType.Stödda villkor inkluderar CellValue, Expression, ColorScale, DataBar,och IconSet.

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

---

### Data Validering

`Worksheet.Validations` Återkommer A `ValidationCollection`.- ringa `Add(CellArea)` För att skapa en `Validation` för en cellriktning. ställa in den `Type` Ejendom Användning `ValidationType` (`List`, `Decimal`,eller `Custom`• Konfigurera `Formula1`, `Formula2`, `Operator`, `InputTitle`, `InputMessage`, `ErrorTitle`,och `ErrorMessage`.

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

Autofilter

Worksheet.AutoFilter Exponerar den AutoFilter objektet Set AutoFilter.Range att definiera header rad ramar. Access AutoFilter.FilterColumns (en samling) och ringa Add(columnIndex) att aktivera filtrering på en viss kolumn.

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

---

### Hyperlänkar och definierade namn

`Worksheet.Hyperlinks` är A `HyperlinkCollection`.- ringa `Add()` att ange externa URL, interna celler referenser eller mailto länkar. `Hyperlink.TextToDisplay` och `Hyperlink.ScreenTip` för användarvänliga text. `Workbook.DefinedNames` är A `DefinedNameCollection`;· ringa `Add(name, refersTo)` att skapa namngivna ringar.

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

Sidan Setup

Worksheet.PageSetup kontrollerar tryckmargin, orientering, pappersstorlek, tryckt område, rubrik rader/kolumner, huvuden, foten och sidbromsar. PageOrientationType och PaperSizeType Enum är.

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

---

### Arbetsbok förvaltning

Lägg till, renamn, dölja och ordna arbetsblad genom `WorksheetCollection`. `WorksheetCollection.Add(name)` returnerar indexet för det nya skivorna. Set `Worksheet.VisibilityType` Användning `VisibilityType`.Förenade celler med `Cells.Merge()` och kontroll rad/kolumn storlek via `Cells.Rows` och `Cells.Columns`.

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

Tips och bästa praxis

• Alltid fångar WorkbookLoadException När du laddar filer från användar-supporterade vägar.
• Användning Cell.PutValue() med exakt .NET-typ du vill lagra - passera decimal för valutan, DateTime för datum.
• Läsning Cell.StringValue för att visa text; användning Cell.Value När du behöver rå .NET objekt.
• Skapa villkorliga formatregler på det bredaste spektrum du behöver - per-row regler är dyra i stora skivor.
• Call wb.Save() En gång i slutet snarare än efter varje cell skriver.

Vanliga frågor

FAQ

Behöver Aspose.Cells FOSS för .NET Microsoft Office?

Biblioteket är ren hanterad kod utan att vara beroende av Office, Excel eller COM-interop.

Vilka filformat stöds?

CSV, ODS, PDF och binär XLS stöds inte i den här versionen.

Kan jag använda den här biblioteket i en kommersiell applikation?

Aspose.Cells FOSS publiceras enligt MIT-licensen, som tillåter obegränsad kommersiell användning utan royalty.

Vad är den minsta .NET-versionen?

.NET 6.0 eller senare.

Hur applicerar jag en bakgrundsfärg på en cell?

Setade style.Pattern = FillPattern.Solid och style.ForegroundColor = Color.FromArgb(...),Och sedan ringer cell.SetStyle(style).

API Referens sammanfattning

Se även

• Aspose.Cells for .NET — Enterprise Documentation