Comment définir les formats de données des cellules en C# ; avec IronXL

Comment définir les formats de données des cellules dans Excel?

La propriété FormatString est accessible à la fois via les cellules et les plages. Il est donc possible de définir des formats de données pour chaque cellule, colonne, ligne et toute plage sélectionnée. Cette flexibilité rend IronXL particulièrement puissant lorsque vous devez travailler avec des fichiers Excel en C# sans Interop.

Le formatage des données est essentiel pour présenter clairement les informations dans les feuilles de calcul. Qu'il s'agisse de créer des rapports financiers avec des valeurs monétaires, des données scientifiques avec des décimales précises ou des analyses basées sur des dates, un formatage approprié garantit que vos données sont à la fois lisibles et professionnelles. IronXL simplifie ce processus en fournissant un accès direct au moteur de mise en forme d'Excel par le biais d'une API simple.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format.cs

using IronXL;
using IronXL.Formatting;
using System;
using System.Linq;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the data format to 12300.00%
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Percent2;

// Set the data format to 123.0000
workSheet["A2"].Value = 123;
workSheet["A2"].FormatString = "0.0000";

// Set data display format to range
DateTime dateValue = new DateTime(2020, 1, 1, 12, 12, 12);
workSheet["A3"].Value = dateValue;
workSheet["A4"].Value = new DateTime(2022, 3, 3, 10, 10, 10);
workSheet["A5"].Value = new DateTime(2021, 2, 2, 11, 11, 11);

IronXL.Range range = workSheet["A3:A5"];

// Set the data format to 1/1/2020 12:12:12
range.FormatString = "MM/dd/yy h:mm:ss";

workBook.SaveAs("dataFormats.xlsx");

:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-stringvalue.cs

// Assign value as string
workSheet["A1"].StringValue = "4402-12";

Comment utiliser les formats intégrés dans IronXL?

La bibliothèque IronXL propose diverses chaînes de format prédéfinies accessibles via la classe IronXL.Formatting.BuiltinFormats pour la mise en forme des cellules Excel. Cela vous permet de personnaliser l'affichage des données dans vos feuilles de calcul Excel. Ces formats intégrés couvrent les scénarios commerciaux les plus courants et sont compatibles avec toutes les versions d'Excel.

Lorsque création de feuilles de calcul par programme, l'application d'une mise en forme cohérente est cruciale pour maintenir des normes professionnelles dans l'ensemble de vos documents. La classe BuiltinFormats fournit plus de 30 modèles de format préconfigurés qui correspondent aux options de formatage standard d'Excel.

:path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-builtin-formats.cs

using IronXL;
using IronXL.Formatting;

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Use builtin formats
workSheet["A1"].Value = 123;
workSheet["A1"].FormatString = BuiltinFormats.Accounting0;

workBook.SaveAs("builtinDataFormats.xlsx");

Quels sont les formats de données intégrés disponibles ?

Pour le type Duration , les valeurs d'entrée sont exprimées en jours. Par exemple, 1 jour équivaut à 24 heures, et 1,05 jour équivaut à 25 heures et 12 minutes. Ceci est particulièrement utile lorsque travaille avec des données Excel qui impliquent le suivi du temps ou la gestion de projet. Voici les types de format disponibles :

Qu'est-ce que chaque type de format fait?

• Général : Format par défaut affichant des nombres sans formatage spécifique.
• Duration1 : Affiche la durée en minutes et secondes comme "mm:ss"
• Duration2 : Affiche la durée en heures, minutes et secondes comme "[h]:mm:ss."
• Duration3 : affiche la durée en minutes, secondes et millisecondes comme "mm:ss.0"
• Comptabilité0 : Format comptable sans décimales, parenthèses pour les négations comme "#,##0_) ;(#,##0)"
• Comptabilité0Rouge : Format comptable sans décimales, rouge pour les négations comme "#,##0_);Red."
• Comptabilité2 : Format comptable avec deux décimales, parenthèses pour les négations comme "#,##0.00 ;(#,##0.00)."
• Comptabilité2Rouge : Format de comptabilité avec deux décimales, rouge pour les négatives comme "#,##0.00_);Red."
• Time1 : format 12 heures avec AM/PM comme "h:mm AM/PM"
• Time2 : format 12 heures avec secondes et AM/PM comme "h:mm:ss AM/PM"
• Time3 : format de 24 heures sans les secondes comme "h:mm."
• Time4 : format de 24 heures avec des secondes comme "h:mm:ss."
• ShortDate : format de date court comme "m/d/yy"
• ShortDateAndTime : format court de date et d'heure tel que "m/d/yy h:mm."
• LongDate1 : Date longue avec le mois, le jour, l'année comme "d-mmm-yy"
• Date longue2 : Date longue avec le jour et le mois abrégé comme "d-mmm"
• Date longue3 : Date longue avec mois et année abrégés comme "mmm-yy"
• Fraction1 : Valeurs fractionnaires avec un chiffre comme "# ?/ ?"
• Fraction2 : Valeurs fractionnaires à deux chiffres comme "# ??/ ??"
• Scientifique1 : notation scientifique avec une décimale comme "##0.0E+0"
• Scientific2 : notation scientifique avec deux décimales comme "0.00E+00"
• Pourcentage : Pourcentage sans décimales comme "0%"
• Percent2 : Pourcentage avec deux décimales comme "0,00%"
• Monnaie0 : Monnaie sans décimales, parenthèses pour les négations comme "$#,##0_) ;($#,##0)."
• Monnaie0Rouge : Monnaie sans décimales, rouge pour les négatives comme "$#,##0_);Red"
• Monnaie2 : Monnaie avec deux décimales, parenthèses pour les négations comme "$#,##0.00 ;($#,##0.00)"
• Monnaie2Rouge : Monnaie avec deux décimales, rouge pour les négatives comme "$#,##0.00_);Red"
• Milliers0 : nombres avec séparateur de milliers, sans décimales comme "#,##0"
• Thousands2 : Nombres avec séparateur de milliers, deux décimales comme "#,##0.00."
• Nombre0 : Les nombres sans décimales comme "0"
• Number2 : Les nombres avec deux décimales comme "0.00"
• Texte : Format de texte brut comme "@."

Le formatage des données et des nombres dans Excel contrôle la manière dont les nombres, les dates, les heures et d'autres données s'affichent dans les cellules, améliorant ainsi la lisibilité et garantissant l'exactitude des données. Grâce aux formats de données, vous pouvez présenter les informations dans des formats spécifiques tels que les pourcentages ou les devises. De même, les formats numériques vous permettent de personnaliser le nombre de décimales et les options d'affichage.

Comment appliquer plusieurs formats à différentes plages ?

Dans les applications réelles, vous devez souvent appliquer différents formats à diverses parties de votre feuille de calcul. Cet exemple montre le formatage d'un rapport financier avec plusieurs types de données. Cette approche est particulièrement utile lors de l'exportation vers Excel en C# à partir de bases de données ou d'autres sources de données :

/* :path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-financial-report.cs */
using IronXL;
using IronXL.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXL.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");

/* :path=/static-assets/excel/content-code-examples/how-to/set-cell-data-format-financial-report.cs */
using IronXL;
using IronXL.Formatting;
using System;

// Create a financial report with multiple formats
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Headers
workSheet["A1"].Value = "Financial Report Q4 2023";
workSheet["A1"].Style.Font.Bold = true;

// Revenue section with currency formatting
workSheet["A3"].Value = "Revenue";
workSheet["B3"].Value = 2500000;
workSheet["B3"].FormatString = BuiltinFormats.Currency0;

// Growth percentage
workSheet["A4"].Value = "YoY Growth";
workSheet["B4"].Value = 0.157;
workSheet["B4"].FormatString = BuiltinFormats.Percent2;

// Date formatting
workSheet["A6"].Value = "Report Date";
workSheet["B6"].Value = DateTime.Now;
workSheet["B6"].FormatString = BuiltinFormats.LongDate1;

// Apply accounting format to expense columns
IronXL.Range expenseRange = workSheet["B8:B12"];
expenseRange.FormatString = BuiltinFormats.Accounting2Red;

// Save the formatted report
workBook.SaveAs("FinancialReport_Q4_2023.xlsx");

Cet exemple montre comment différents types de formats se combinent pour créer des documents financiers professionnels. Pour des options de formatage plus avancées, y compris formatage conditionnel, vous pouvez approfondir ces concepts.

Lorsque l'on travaille avec de grands ensembles de données ou que l'on crée des rapports par programme, il est essentiel que le formatage soit cohérent. Le système de formatage d'IronXL s'intègre parfaitement à d'autres fonctionnalités telles que fonctions mathématiques et formules d'édition, ce qui vous permet de créer des solutions de reporting entièrement automatisées.

Pour les développeurs qui migrent depuis Office Interop ou qui recherchent de meilleures performances, le système de formatage d'IronXL offre un avantage significatif. Contrairement aux approches traditionnelles, vous pouvez formater des milliers de cellules efficacement sans surcharge d'interopérabilité COM. Pour en savoir plus sur les meilleures pratiques d'automatisation d'Excel, consultez notre documentation complète sur Excel.