caractéristiques

caractéristiques

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 classe, qui fournit l’accès aux feuilles de travail, les noms définis et les opérations d’enregistrement/charge. Cette page résume chaque domaine majeur avec des exemples de code courts.

Book de travail Créer, charger et enregistrer

Créer un nouveau livre de travail avec new Workbook().Coupez un fichier XLSX existant en passant une voie de fichie au constructeur.Utiliser LoadOptions Pour permettre la charge tolérante des erreurs. appeler Workbook.Save(path) Pour persister les changements.

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

Les données cellulaires et les formules

Utiliser Cell.PutValue() pour écrire des lignes, des enveloppes, les décimales, le boolean et DateTime Étape : Set Cell.Formula pour attribuer une ligne de formulation compatible avec Excel. Lire le texte d’affichage via Cell.StringValue et la valeur primaire par le biais de 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

Styling cellulaire

Rétrouvez et modifiez le Style pour toute cellule avec Cell.GetStyle() et Cell.SetStyle().Le Style La classe fournit Font (Bold, italien, taille et nom), ForegroundColor, Pattern (dans le type FillPattern), HorizontalAlignment (Utiliser HorizontalAlignmentTypeet le contrôle des frontières par la 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");

Formatisation conditionnelle

Worksheet.ConditionalFormattings Retour à A ConditionalFormattingCollection.- appeler Add() pour créer une règle, puis AddCondition() Pour ajouter des règles d’utilisation FormatConditionType et OperatorType.Les types de conditions soutenues incluent CellValue, Expression, ColorScale, DataBar,et 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");

Validation des données

Worksheet.Validations Retour à A ValidationCollection.- appeler Add(CellArea) Pour créer un Validation pour une cellule de rang. Sélectionnez le Type Propriété utilisée ValidationType (List, Decimal,ou Custom• Configurer Formula1, Formula2, Operator, InputTitle, InputMessage, ErrorTitle,et 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");

Filtre automatique

Worksheet.AutoFilter Exposer le AutoFilter Objet : Set AutoFilter.Range Définir le champ de rang d’écran.Access AutoFilter.FilterColumns (une collection) et appeler Add(columnIndex) Pour activer le filtre sur une colonne spécifique.

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 et noms définis

Worksheet.Hyperlinks est un HyperlinkCollection.- appeler Add() Pour insérer des URL externes, des références cellulaires internes ou des liens mailto. Hyperlink.TextToDisplay et Hyperlink.ScreenTip pour le texte utilisateur. Workbook.DefinedNames est un DefinedNameCollection;• Appel Add(name, refersTo) Créer des rangs nommés.

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

Page de configuration

Worksheet.PageSetup contrôler les marges d’impression, l’orientation, la taille du papier, le domaine d’imprimage, les rangs/columnes de titre, des têtes, et les pauses de page. PageOrientationType et PaperSizeType Enumés !.

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

Gestion de feuilles de travail

Ajouter, renommer, cacher et réorder les feuilles de travail par le biais WorksheetCollection. WorksheetCollection.Add(name) Retourner l’index de la nouvelle feuille. Worksheet.VisibilityType Utiliser VisibilityType.Mélanger les cellules avec Cells.Merge() et contrôle de la ligne/colonne par le biais Cells.Rows et 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");

Conseils et meilleures pratiques

• Toujours capture WorkbookLoadException Lorsque vous téléchargez des fichiers à partir de chemins fournis par l’utilisateur.
• Utiliser Cell.PutValue() avec le type .NET exact que vous souhaitez stocker - passez decimal Pour la monnaie, DateTime pour les dates.
• Lire Cell.StringValue pour le texte de l’affichage ; utilisation Cell.Value Vous avez besoin de l’objet .NET.
• Créez des règles de formatage conditionnels sur la gamme la plus large dont vous avez besoin - les règlements par rouleau sont coûteux dans les grandes feuilles.
• Appel à wb.Save() Une fois à la fin plutôt que après chaque cellule écrire.

Les problèmes communs

FAQ

Les cellules Aspose.Cells FOSS pour .NET nécessitent-elles Microsoft Office ?

La bibliothèque est un code géré pur sans dépendance sur Office, Excel ou COM interop.

Quels formats de fichiers sont soutenus ?

CSV, ODS, PDF et XLS binaires ne sont pas supportés dans cette version.

Puis-je utiliser cette bibliothèque dans une application commerciale?

Oui. Aspose.Cells FOSS est publié sous la licence MIT, qui permet un usage commercial illimité sans royalties.

Quelle est la version .NET minimum ?

.NET 6.0 ou plus tard.

Comment appliquer une couleur de fond à une cellule ?

Sélection style.Pattern = FillPattern.Solid et style.ForegroundColor = Color.FromArgb(...),Et puis appeler cell.SetStyle(style).

Le résumé de référence API

Voir aussi

• Aspose.Cells for .NET — Enterprise Documentation