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

---

```csharp
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

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

---

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

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

---

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

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

---

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

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

---

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

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

---

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

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

---

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

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

---

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

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