Eigenschaften

Eigenschaften

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 Diese Seite fasst alle wichtigen Funktionsbereiche mit kurzen Codebeispielen zusammen.

Arbeitsbuch Erstellen, Laden und Speichern

Erstellen Sie ein neues Arbeitsbuch mit: new Workbook(). Laden Sie eine vorhandene XLSX-Datei, indem Sie einen Pfad an den Konstruktor weitergeben. Verwenden LoadOptions Die Anforderung der Zentralen Behörde ist nicht zu übersehen. Workbook.Save(path) Veränderungen aufrechtzuerhalten.

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

Zelldaten und Formeln

Verwendung Cell.PutValue() um Zeichenfolgen, Ganzzahlen, Dezimalzahlen und Booleanzahlungen zu schreiben. DateTime Werte festgelegt. Cell.Formula um eine Excel-kompatible Formel zuzuweisen. Lesen Sie den Text über die Anzeige zurück Cell.StringValue und der Rohwert über die 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

Zell-Styling

Erhalten und ändern Sie die Style Objekt für jede Zelle mit: Cell.GetStyle() und . Cell.SetStyle().Die . Style Klasse stellt vor, Font (fett, kursiv, Größe, Name), ForegroundColor, Pattern (von der Art von FillPattern), HorizontalAlignment (mit Hilfe von HorizontalAlignmentType), und Grenzkontrollen durch die 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");

Bedingtes Formatieren

Worksheet.ConditionalFormattings gibt a zurück. ConditionalFormattingCollection.Rufen Sie an . Add() um einen Regelsatz zu erstellen, dann AddCondition() Regeln hinzufügen FormatConditionType und OperatorType.Unterstützte Zustandstypen umfassen: CellValue, Expression, ColorScale, DataBar, und 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");

Datenvalidierung

Worksheet.Validations gibt a zurück ValidationCollection.Rufen Sie an . Add(CellArea) Erstellung einer Validation für einen Zellbereich. Type Eigentum mit ValidationType (List, Decimal,oder , Custom) Konfiguration Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle,und . 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");

Automatischer Filter

Worksheet.AutoFilter Die Kommission hat die AutoFilter Objekt. Set AutoFilter.Range Um den Bereich der Headerzeilen zu definieren. Access AutoFilter.FilterColumns (eine Sammlung) und Aufruf Add(columnIndex) die Filterung auf einer bestimmten Spalte zu aktivieren.

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

Hyperlinks und definierte Namen

Worksheet.Hyperlinks ist ein HyperlinkCollection.- Rufen Sie an . Add() um externe URLs, interne Zellverweise oder Mailto-Links einzufügen. Setzen Hyperlink.TextToDisplay und . Hyperlink.ScreenTip für den benutzerorientierten Text. Workbook.DefinedNames ist ein DefinedNameCollection; Anrufen Add(name, refersTo) um benannte Bereiche zu erstellen.

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

Seitenaufbau

Worksheet.PageSetup Die Kontrollen für Druckmargen, Orientierung, Papiergröße, Druckabschnitt, Titelzeilen/Spalten, Überschriften und Fußzeiten sowie Seitenunterbrechungen. PageOrientationType und . PaperSizeType - Ich bin nicht hier.

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

Arbeitsblattverwaltung

Arbeitsblätter durch Hinzufügen, Umbenennen, Verstecken und Neuordnen WorksheetCollection. WorksheetCollection.Add(name) gibt den Index des neuen Blattes zurück. Set Worksheet.VisibilityType Verwendung von VisibilityType.Zellen mit der Cells.Merge() und Kontrollzeilen/Spaltengröße über Cells.Rows und . 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");

Tipps und beste Praktiken

• Immer fangen. WorkbookLoadException beim Laden von Dateien aus vom Benutzer bereitgestellten Pfaden.
• Verwendung Cell.PutValue() mit dem genauen .NET-Typ, den Sie speichern möchten Pass decimal für Währung, DateTime für Dates.
• Lesen Sie . Cell.StringValue für die Anzeige des Textes; Verwendung Cell.Value Wenn Sie das Roh-NET-Objekt benötigen.
• Erstellen Sie bedingte Formatierungsregelsätze im breitesten Bereich, den Sie benötigen Regeln pro Zeile sind in großen Blättern teuer.
• Rufen Sie an . wb.Save() Schreiben Sie einmal am Ende, nicht nach jeder Zelle.

Häufige Probleme

FAQ

Ist Microsoft Office erforderlich, wenn Aspose.Cells FOSS für .NET verwendet wird?

Die Bibliothek ist reiner verwalteter Code ohne Abhängigkeit von Office, Excel oder COM-Interop.

Welche Dateiformate werden unterstützt?

CSV, ODS, PDF und binäre XLS werden in dieser Version nicht unterstützt.

Kann ich diese Bibliothek in einer kommerziellen Anwendung verwenden?

Ja, Aspose.Cells FOSS wird unter der MIT-Lizenz veröffentlicht, die uneingeschränkte kommerzielle Nutzung ohne Lizenzgebühren erlaubt.

Welche ist die Mindestversion von .NET?

.NET 6.0 oder neuer.

Wie kann ich eine Hintergrundfarbe auf eine Zelle anwenden?

Setz style.Pattern = FillPattern.Solid und . style.ForegroundColor = Color.FromArgb(...),Dann ruf an . cell.SetStyle(style).

Zusammenfassung der API-Referenzen