Εισαγωγή

Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, Η χειραγώγηση του Excel .xlsx βιβλία εργασίας χωρίς καμία εξάρτηση Microsoft Office. εγκατεστημένο ως Η Aspose.Cells_FOSS NuGet πακέτο, ενσωματώνεται σε οποιοδήποτε .NET έργο — εφαρμογές κονσόλας, web APIs, εργαζόμενοι υπόβαθρου και λειτουργίες χωρίς διακομιστή.

Αυτή η ανάρτηση παρέχει έναν οδηγό χαρακτηριστικό-κατά-χαρακτηριστικό του δημόσιου API, δείχνοντας τι είναι δυνατόν και πώς να καλέσετε κάθε δυνατότητα από κώδικα C#.

Επισκόπηση Χαρακτηριστικών

Κύκλος Ζωής Βιβλίου Εργασίας και Φύλλου Εργασίας

Το σημείο εισόδου για κάθε επιχείρηση είναι η Workbook Κλάση: Δημιουργήστε ένα από το σκάκι με new Workbook(),ή να φορτίσει ένα υπάρχον .xlsx Με new Workbook(filePath) ή new Workbook(stream).Ναυτιλία μέσω Workbook.Worksheets,ΣΕΤΙΔΑ Worksheet.Name και Worksheet.VisibilityType,και συνεχίζει με Workbook.Save().Για τα κατεστραμμένα αρχεία, μεταβείτε σε LoadOptions Η περίπτωση με TryRepairPackage = true και TryRepairXml = true.

using Aspose.Cells_FOSS;

var options = new LoadOptions
{
    TryRepairPackage = true,
    TryRepairXml = true,
};

try
{
    _ = new Workbook("sample.xlsx", options);
}
catch (WorkbookLoadException exception)
{
    Console.WriteLine(exception.Message);
}

Δεδομένα Κελιών και Τύποι

Γράψτε τιμές στα κύτταρα με Cell.PutValue() - Υπερφόρτωση αποδοχή string, int, double, decimal, bool,και DateTime.Διαβάστε τις τιμές πίσω μέσω Cell.Value, Cell.StringValue,και Cell.Formula.Εισάγετε τις φόρμουλες του Excel με το Cell.Formula Η διατύπωση: η φόρμουλα είναι διατηρείται και επιβιώνει έναν κύκλο επαναφόρτωσης.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";

workbook.Save("hello.xlsx");

var loaded = new Workbook("hello.xlsx");
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].Formula);
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].StringValue);

Στυλ Κελιών

Εφαρμογή Style αντικείμενα για να ελέγξει τη γραμματοσειρά, συμπληρώστε, τα όρια, τον μορφότυπο αριθμών και την ευθυγράμμιση. Επαναλάβετε το τρέχον στυλ με Cell.GetStyle(),αλλάζει, και στη συνέχεια δεσμεύεται με Cell.SetStyle().Για τα φόντα, το Set Style.Pattern = FillPattern.Solid και προσδιορίζει ένα Color Για να Style.ForegroundColor.Χρησιμοποιήστε Cells.Merge() να διατηρήσουν κυτταρικά ράφια.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var cell = workbook.Worksheets[0].Cells["A1"];
cell.PutValue("Styled");

var style = cell.GetStyle();
style.Font.Bold = true;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 241, 196, 15);
cell.SetStyle(style);

Console.WriteLine($"{cell.StringValue} / Bold={cell.GetStyle().Font.Bold}");

Μορφοποίηση υπό Όρους

Προσθήκη των κανόνων τυποποίησης υπό όρους σε κυτταρικές γραμμές μέσω ConditionalFormattingCollection. Κανόνες υποστήριξης FormatConditionType.CellValue, Expression, ColorScale, DataBar,και IconSet.Χρησιμοποιήστε OperatorType Για να προσδιορίσετε τις συγκριτικές λειτουργίες (Between, Equal, GreaterThan, κλπ.), προσθέτοντας ένα Style να ταιριάζει στα κύτταρα, και να καθορίσει την προτεραιότητα και Σταματήστε την αληθινή συμπεριφορά με κανόνα.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];

var cfCollection = sheet.ConditionalFormattings[sheet.ConditionalFormattings.Add()];
cfCollection.AddArea(CellArea.CreateCellArea("A1", "A10"));
var rule = cfCollection[cfCollection.AddCondition(
    FormatConditionType.CellValue, OperatorType.Between, "3", "7")];
var style = rule.Style;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 255, 199, 206);
style.Font.Bold = true;
rule.Style = style;

workbook.Save("conditional-formatting.xlsx");

Επικύρωση Δεδομένων

Προσθήκη περιορισμών εισόδου στα κύτταρα που χρησιμοποιούν Worksheet.Validations.Υποστηριζόμενοι τύποι επικύρωσης περιλαμβάνει ValidationType.List, Decimal, Custom,και άλλα.Προσωπεί τις εισαγωγές (InputTitle, InputMessageκαι τα μηνύματα σφάλματος (ErrorTitle, ErrorMessage, ValidationAlertType• Χρησιμοποιήστε CellArea.CreateCellArea() να καθορίσει το επιβεβαιωμένο εύρος και Validation.AddArea() να εφαρμόσει έναν κανόνα σε πρόσθετες ράντες.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Validation Sheet";

var listIdx = sheet.Validations.Add(CellArea.CreateCellArea("A1", "A3"));
var listVal = sheet.Validations[listIdx];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,Closed\"";
listVal.IgnoreBlank = true;
listVal.InCellDropDown = true;
listVal.ShowInput = true;
listVal.InputTitle = "Status";
listVal.InputMessage = "Pick a status";
listVal.ShowError = true;
listVal.ErrorTitle = "Invalid";
listVal.ErrorMessage = "Choose from the list";

workbook.Save("validations-sample.xlsx");

Διαμόρφωση Σελίδας και Επιλογές Εκτύπωσης

Εισαγωγή του διαγράμματος μέσω Worksheet.PageSetup.Η ΜΑΡΓΑΝΗ (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize,Η κλίμακα, περιοχή εκτύπωσης, γραμμές τίτλου και στήλες, κεφαλίδες και πόδια, και διακοπές σελίδας. όλες οι ρυθμίσεις επιβιώνουν Ένα ταξίδι με αποθήκευση.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Print Sheet";
sheet.Cells["A1"].PutValue("Title");

var pageSetup = sheet.PageSetup;
pageSetup.Orientation = PageOrientationType.Landscape;
pageSetup.PaperSize = PaperSizeType.PaperA4;
pageSetup.PrintArea = "$A$1:$C$10";
pageSetup.PrintTitleRows = "$1:$2";
pageSetup.LeftHeader = "Left Header";
pageSetup.CenterFooter = "Center Footer";
pageSetup.PrintGridlines = true;
pageSetup.CenterHorizontally = true;

workbook.Save("page-setup-sample.xlsx");

Ρυθμίσεις Φύλλου Εργασίας και Προστασία

Ελέγχοντας την οθόνη με Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom,και TabColor.Προστατεύστε τα φύλλα με Worksheet.Protect() και να δημιουργήσουν το φινέζικο Protection Η σημαία (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCellsΔιαχειριστείτε το ύψος της γραμμής, το πλάτος των στήλων, τις κρυφές σειρές/στήλες και Η ενσωμάτωση των περιοχών μέσω Cells.Rows, Cells.Columns,και Cells.Merge().

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var layout = workbook.Worksheets[0];
layout.Name = "Layout";
layout.VisibilityType = VisibilityType.Hidden;
layout.TabColor = Color.FromArgb(255, 34, 68, 102);
layout.ShowGridlines = false;
layout.Zoom = 85;
layout.Protect();
layout.Protection.FormatCells = true;
layout.Protection.InsertRows = true;

layout.Cells["A1"].PutValue("Merged");
layout.Cells.Rows[1].Height = 22.5d;
layout.Cells.Columns[0].Width = 18.25d;
layout.Cells.Merge(0, 0, 2, 2);

workbook.Save("worksheet-settings-sample.xlsx");

Υπερσυνδέσεις και Ονομαστικές Περιοχές

Εισάγετε εξωτερικά, εσωτερικά και mailto: Hyperlinks μέσω HyperlinkCollection.Add().ΣΕΤΙΔΑ Hyperlink.TextToDisplay και Hyperlink.ScreenTip για ετικέτες που είναι ορατές από τον χρήστη.Προσδιορίστε το όνομα Σημειώσεις στο βιβλίο εργασίας ή το εύρος φύλλων χρησιμοποιώντας DefinedNameCollection.Add() - τα ονόματα των ράγκων χρησιμεύουν ως σταθερή φόρμουλα ανακρίσεις και χάρτη πηγές δεδομένων που επιβιώνουν το αρχείο επαναφορτίσει.

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];

sheet.Cells["A1"].PutValue("Docs");
var link = sheet.Hyperlinks[sheet.Hyperlinks.Add("A1", 1, 1, "https://example.com/docs")];
link.TextToDisplay = "Docs";
link.ScreenTip = "External documentation";

var name = workbook.DefinedNames[workbook.DefinedNames.Add("PrimaryRange", "='Sheet1'!$A$1:$D$5")];
name.Comment = "Primary data range";

workbook.Save("hyperlinks-names.xlsx");
Console.WriteLine("Hyperlinks: " + sheet.Hyperlinks.Count);
Console.WriteLine("Defined names: " + workbook.DefinedNames.Count);

Γρήγορη έναρξη

dotnet add package Aspose.Cells_FOSS

using Aspose.Cells_FOSS;

var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";
workbook.Save("output.xlsx");

Υποστηριζόμενες μορφές

ΤΕΧΝΗΕΠΙΤΡΟΦΗΔιαβάστεΓράψε
Xlsx.XLSX✓✓
Αυτοκίνητα(Παρακάθαρη από διαφορετική)✓—

Ανοικτή Πηγή & Άδεια Χρήσης

Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as Aspose.Cells_FOSS.Είναι κατάλληλο για έργα ανοικτού κώδικα και εμπορικά.

Ξεκινώντας