Χαρακτηριστικά

Χαρακτηριστικά

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 Κλάση, η οποία παρέχει πρόσβαση σε φύλλα εργασίας, ορισμένα ονόματα και λειτουργίες αποθήκευσης/αποθήκης. Αυτή η σελίδα συνοψίζει κάθε κύριο πεδίο χαρακτηριστικών με σύντομα παραδείγματα κώδικα.

Το βιβλίο εργασίας Δημιουργεί, Κατεβάζει και Σώζει

Δημιουργία ενός νέου βιβλίου εργασίας με new Workbook(). Κατεβάστε ένα υπάρχον αρχείο XLSX με την περάτωση ενός δρομολογίου αρχείου στον κατασκευαστή. LoadOptions για να επιτρέψει την ανεκτικότητα ελαττωματικών φορτίων. κάλεσε Workbook.Save(path) Να συνεχίσουν οι αλλαγές.

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

Πληροφορίες και φόρμουλα κελιών

Χρησιμοποιήστε Cell.PutValue() να γράφουν γραμμές, ενσωμάτωματά, δεκάδες, μπολεάν και DateTime ΣΕΤΙΔΑ - SET Cell.Formula να αναθέσετε μια γραμμή φόρμουλα συμβατή με το Excel. Διαβάστε πίσω το κείμενο που εμφανίζεται μέσω Cell.StringValue Η αξία του πλούτου μέσω 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

Στυλ κελιών

Ανακαλύψτε και τροποποιήστε το Style Οποιοδήποτε κελί με το Cell.GetStyle() και Cell.SetStyle().Η Style Η τάξη παρέχει Font (Πολύ, Ιταλικά, Μέγεθος και Όνομα), ForegroundColor, Pattern (Σε τύπο FillPattern), HorizontalAlignment (χρησιμοποιώντας HorizontalAlignmentTypeκαι ο έλεγχος των συνόρων μέσω της 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");

Συνθησιακή μορφοποίηση

Worksheet.ConditionalFormattings Επιστρέφει ο Α ConditionalFormattingCollection.Κλήση Add() να δημιουργήσει ένα σύνολο κανόνων, και στη συνέχεια AddCondition() Προσθέστε κανόνες για τη χρήση FormatConditionType και OperatorType.Οι υποστηριζόμενες συνθήκες περιλαμβάνουν CellValue, Expression, ColorScale, DataBar,και 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");

Εγκρίσεις δεδομένων

Worksheet.Validations Επιστρέφει ο Α ValidationCollection.Κλήση Add(CellArea) Για να δημιουργήσουμε ένα Validation για μια κελιά. να ρυθμίσετε το Type Χρησιμοποιώντας την ιδιοκτησία ValidationType (List, Decimal,ή Custom• Επεξεργασία Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle,και 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");

Αυτο-Φιλτράρισμα

Worksheet.AutoFilter Εμφανίζει το AutoFilter Συσκευή - Set AutoFilter.Range Για να καθορίσετε το εύρος γραμμής κεφαλιού. πρόσβαση AutoFilter.FilterColumns (από συλλογή) και καλέστε Add(columnIndex) Για να ενεργοποιήσετε την φιλτραρίσματος σε μια συγκεκριμένη στήλη.

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 και ορισμένα ονόματα

Worksheet.Hyperlinks Είναι η HyperlinkCollection.Κλήση Add() για να εισαγάγετε εξωτερικές URL, εσωτερικές αναφορές κυττάρων ή mailto συνδέσεις. Hyperlink.TextToDisplay και Hyperlink.ScreenTip για το χρήστη-προσωπικό κείμενο. Workbook.DefinedNames Είναι η DefinedNameCollection;· Κλήση Add(name, refersTo) Δημιουργία ονομαστικών ράβδων.

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

Σελίδα Setup

Worksheet.PageSetup ελέγχει τα περιθώρια εκτύπωσης, την κατεύθυνση, το μέγεθος του χαρτιού, τη ζώνη εκτυπώσεως, τις γραμμές/κλώνες τίτλου, τους επικεφαλίδες, τα πόδια και τις διακοπές της σελίδας. PageOrientationType και PaperSizeType Ο ΕΝΟΜ.

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

Διαχείριση εργαστηρίων

Προσθήκη, αναφορά, κρύβοντας και επαναδιαταγή φύλλων εργασίας μέσω WorksheetCollection. WorksheetCollection.Add(name) επιστρέφει τον δείκτη του νέου φύλλου. Worksheet.VisibilityType Χρησιμοποιώντας VisibilityType.- Συμμετοχή των κυττάρων με Cells.Merge() και ελέγχου γραμμής / στήλης μέτρησης μέσω Cells.Rows και 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");

Συμβουλές και βέλτιστες πρακτικές

• Πάντα να πιέζεις WorkbookLoadException όταν φορτώνετε αρχεία από τα διαδρομές που παρέχονται από τον χρήστη.
• Χρησιμοποιήστε Cell.PutValue() με τον ακριβή τύπο .NET που σκοπεύετε να αποθηκεύσετε - pass decimal για το νόμισμα, DateTime Για τις ημερομηνίες.
• Διαβάστε Cell.StringValue για την προβολή κειμένου, χρήση Cell.Value Όταν χρειάζεστε το .NET αντικείμενο.
• Δημιουργήστε συνθησιακά ρυθμίσεις κανόνων μορφοποίησης στο ευρύτερο εύρος που χρειάζεστε - οι κανάλες ανά ράβδος είναι ακριβές σε μεγάλα φύλλα.
• Κλήση wb.Save() Μια φορά στο τέλος, αντί μετά από κάθε κελί γράφουν.

κοινά ζητήματα

FAQ

Το Aspose.Cells FOSS για .NET απαιτεί Microsoft Office;?

Η βιβλιοθήκη είναι καθαρός διαχειριζόμενος κώδικας χωρίς εξάρτηση από το Office, Excel ή COM.

Ποια μορφή αρχείων υποστηρίζονται;?

Το CSV, το ODS, τα PDF και το binary XLS δεν υποστηρίζονται σε αυτή την έκδοση.

Μπορώ να χρησιμοποιήσω αυτή τη βιβλιοθήκη σε μια εμπορική εφαρμογή;?

Ναι. Aspose.Cells FOSS δημοσιεύεται σύμφωνα με την άδεια MIT, η οποία επιτρέπει απεριόριστη εμπορική χρήση χωρίς καμία εγγύηση.

Ποια είναι η ελάχιστη έκδοση .NET;?

.NET 6.0 ή αργότερα.

Πώς να εφαρμόσω ένα χρώμα φόντου σε μια κελιά;?

ΣΕΤΙΔΑ style.Pattern = FillPattern.Solid και style.ForegroundColor = Color.FromArgb(...),Στη συνέχεια καλέστε cell.SetStyle(style).

Συνοπτική αναφορά API