1. IronXL
  2. Guides pratiques
  3. Définir les formats de données des cellules
Comment définir les formats de données des cellules dans Excel

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

Chaknith Bin
Chaknith Bin
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

La mise en forme des données et des nombres dans Excel vous permet de contrôler l'affichage des nombres, des dates, des heures et autres données 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.

Démarrage rapide : Appliquer un format intégré à une seule cellule en une seule ligne

Cet exemple montre à quel point il est facile de créer un nouveau classeur Excel et d'appliquer un format intégré à une cellule spécifique à l'aide de l'API d'IronXL. Vous serez opérationnel en quelques secondes, sans aucune dépendance d'interopérabilité : il vous suffit de définir " FormatString " et d'enregistrer.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronXL avec le gestionnaire de packages NuGet

    PM > Install-Package IronXL.Excel

  2. Copiez et exécutez cet extrait de code.

    IronXL.WorkBook book = IronXL.WorkBook.Create(); book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2;

  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronXL dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque C# pour définir le format des données
  2. Ouvrir une feuille de calcul Excel existante ou en créer une nouvelle
  3. Définissez la propriété FormatString de la cellule, de la colonne, de la ligne ou de la plage sur le format de données souhaité.
  4. Utilisez le format de données intégré avec la classe BuiltinFormats
  5. Exporter le tableur modifié dans divers types de fichiers


Exemple de définition des formats de données de cellule

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.

: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");
Imports IronXL
Imports IronXL.Formatting
Imports System
Imports System.Linq

' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Set the data format to 12300.00%
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Percent2

' Set the data format to 123.0000
Private workSheet("A2").Value = 123
Private workSheet("A2").FormatString = "0.0000"

' Set data display format to range
Private dateValue As New DateTime(2020, 1, 1, 12, 12, 12)
Private workSheet("A3").Value = dateValue
Private workSheet("A4").Value = New DateTime(2022, 3, 3, 10, 10, 10)
Private workSheet("A5").Value = New DateTime(2021, 2, 2, 11, 11, 11)

Private range As IronXL.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")
$vbLabelText   $csharpLabel
Format des données

Définir la valeur de la cellule comme chaîne de caractères

Lors de la définition de la valeur dans IronXL, utilisez StringValue au lieu de Value pour attribuer directement la valeur exacte à la cellule sans conversion automatique. Cette utilisation revient à placer une apostrophe avant la valeur de la cellule dans Excel.

:path=/static-assets/excel/content-code-examples/how-to/write-excel-net-assign-stringvalue.cs
// Assign value as string
workSheet["A1"].StringValue = "4402-12";
' Assign value as string
workSheet("A1").StringValue = "4402-12"
$vbLabelText   $csharpLabel

Exemple d'utilisation des formats intégrés

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.

: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");
Imports IronXL
Imports IronXL.Formatting

' Create a new workbook
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Use builtin formats
Private workSheet("A1").Value = 123
Private workSheet("A1").FormatString = BuiltinFormats.Accounting0

workBook.SaveAs("builtinDataFormats.xlsx")
$vbLabelText   $csharpLabel

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. Voici les types de format disponibles :

Tous les formats de données disponibles

Description

  • General : Le format par défaut qui affiche les nombres tels quels, sans mise en forme spécifique.
  • Duration1 : Affiche les durées en minutes et secondes, comme " mm:ss ". Les nombres saisis dans la propriété Value seront considérés comme des jours.
  • Duration2 : Affiche les valeurs de durée en heures, minutes et secondes, comme "[h]:mm:ss".
  • Duration3 : Affiche les valeurs de durée en minutes, secondes et millisecondes, comme "mm:ss.0".
  • Accounting0 : Formate les valeurs comptables sans décimales, en utilisant des parenthèses pour les valeurs négatives, comme "#,##0_);(#,##0)."
  • Accounting0Red : Formate les valeurs comptables sans décimales, en utilisant la couleur rouge pour les valeurs négatives, comme "#,##0_);Red."
  • Accounting2 : Formate les valeurs comptables avec deux chiffres décimaux, en utilisant des parenthèses pour les valeurs négatives, comme "#,##0.00;(#,##0.00)."
  • Accounting2Red : Formate les valeurs comptables avec deux décimales, en utilisant la couleur rouge pour les valeurs négatives, comme "#,##0.00_);Red."
  • Time1 : Formate les valeurs horaires au format horloge 12 heures avec AM/PM, comme "h:mm AM/PM".
  • Time2 : Formate les valeurs horaires au format horloge 12 heures avec secondes et AM/PM, comme "h:mm:ss AM/PM".
  • Time3 : Formate les valeurs horaires au format 24 heures sans secondes, comme "h:mm".
  • Time4 : Formate les valeurs de temps au format d'horloge 24 heures avec les secondes, comme "h:mm:ss".
  • ShortDate : Formate les valeurs de date dans un format court, comme "m/d/yy".
  • ShortDateAndTime : Formate les valeurs de date et d'heure dans un format court, comme "m/d/yy h:mm".
  • LongDate1 : Formate les valeurs de date au format long avec le mois, le jour et l'année, comme "j-mmm-aa".
  • LongDate2 : Formate les valeurs de date au format long avec le jour et le mois abrégé, comme " j-mmm ".
  • LongDate3 : Formate les valeurs de date au format long avec le mois et l'année abrégés, comme "mmm-yy".
  • Fraction1 : Formate les valeurs fractionnaires à un chiffre, comme "# ?/?".
  • Fraction2 : Formate les valeurs fractionnaires à deux chiffres, comme "# ??/??".
  • Scientific1 : Formate les nombres en notation scientifique avec un chiffre après la virgule, comme "##0.0E+0".
  • Scientific2 : Formate les nombres en notation scientifique avec deux chiffres après la virgule, comme "0.00E+00".
  • Percent : Formate les valeurs en pourcentage sans décimales, comme " 0 % ".
  • Percent2 : Formate les valeurs de pourcentage avec deux chiffres décimaux, comme "0,00%".
  • Currency0 : Formate les valeurs monétaires sans décimales, en utilisant des parenthèses pour les valeurs négatives, comme "$#,##0_);($#,##0)."
  • Currency0Red : Formate les valeurs monétaires sans décimales, en utilisant la couleur rouge pour les valeurs négatives, comme "$#,##0_);Red."
  • Currency2 : Formate les valeurs monétaires avec deux chiffres décimaux, en utilisant des parenthèses pour les valeurs négatives, comme "$#,##0.00;($#,##0.00)."
  • Currency2Red : Formate les valeurs monétaires avec deux décimales, en utilisant la couleur rouge pour les valeurs négatives, comme "$#,##0.00_);Red."
  • Thousands0 : Formate les nombres avec un séparateur de milliers et sans décimales, comme "#,##0".
  • Thousands2 : Formate les nombres avec un séparateur de milliers et deux chiffres décimaux, comme "#,##0.00".
  • Number0 : Formate les nombres sans décimales, comme "0".
  • Number2 : Formate les nombres avec deux chiffres décimaux, comme "0,00".
  • Text : Formate les valeurs de texte en texte brut, comme "@" (aucune mise en forme spécifique appliquée).

Questions Fréquemment Posées

Comment puis-je définir des formats de données de cellules dans Excel en utilisant C# ?

Vous pouvez définir des formats de données de cellules dans Excel en utilisant IronXL en accédant à une feuille de calcul et en définissant la propriété FormatString d'une cellule. Cela permet de personnaliser la manière dont les données sont affichées, comme les nombres, les dates et les heures, sans utiliser Interop.

Quels sont les avantages de l'utilisation d'une bibliothèque C# pour la mise en forme des données Excel ?

L'utilisation d'une bibliothèque C# comme IronXL pour la mise en forme des données Excel vous permet de contrôler de manière programmatique l'apparence des données, d'améliorer la lisibilité, d'assurer l'exactitude des données et d'éviter les complexités d'utilisation d'Interop. Cela simplifie les tâches telles que l'établissement de formats de nombres, de dates et de formats personnalisés.

Comment appliquer un format de numéro personnalisé à une cellule dans Excel avec C# ?

Pour appliquer un format de numéro personnalisé à une cellule en utilisant IronXL, chargez votre classeur Excel, accédez à la feuille de calcul et définissez la propriété FormatString de la cellule au format personnalisé souhaité. Par exemple, pour afficher un nombre sous forme de pourcentage, utilisez sheet["A1"].FormatString = "0.00%".

Puis-je préserver les zéros en tête dans les cellules Excel en utilisant une bibliothèque C# ?

Oui, avec IronXL, vous pouvez préserver les zéros en tête en utilisant la propriété StringValue lors de la définition de la valeur d'une cellule. Cette approche empêche la conversion automatique et conserve les zéros en tête dans la cellule.

Comment formater des cellules Excel avec des styles comptables en utilisant C# ?

Pour formater des cellules Excel avec des styles comptables en utilisant IronXL, utilisez la classe BuiltinFormats. Par exemple, vous pouvez appliquer un format comptable avec deux décimales avec sheet["C3"].FormatString = IronXL.Formatting.BuiltinFormats.Accounting2.

Quels sont quelques formats de données prédéfinis disponibles dans une bibliothèque C# pour Excel ?

IronXL fournit des formats de données prédéfinis tels que comptabilité, durée, heure, date, fraction, scientifique, pourcentage, monnaie et nombre. Ces formats intégrés simplifient la personnalisation de la présentation des données dans les feuilles de calcul Excel.

Comment puis-je afficher les valeurs de monnaie négatives en rouge dans Excel en utilisant C# ?

Pour afficher les valeurs de monnaie négatives en rouge en utilisant IronXL, définissez la propriété FormatString sur un format de monnaie qui inclut le rouge pour les négatifs, tel que Currency0Red ou Currency2Red. Par exemple : sheet["B4"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2Red.

Quelle est la différence entre les formats Number0 et Number2 dans IronXL ?

Dans IronXL, le format Number0 affiche les nombres sans chiffres décimaux, tandis que le format Number2 affiche les nombres avec deux chiffres décimaux. Ces formats aident à personnaliser la précision des données numériques dans les feuilles Excel.

Comment enregistrer les modifications apportées à un classeur Excel après l'avoir formaté en utilisant C# ?

Pour enregistrer les modifications apportées à un classeur Excel après l'avoir formaté avec IronXL, utilisez la méthode SaveAs sur l'objet WorkBook. Spécifiez le nom de fichier et le format souhaités pour enregistrer le classeur mis à jour.

Quels sont quelques conseils de dépannage pour définir des formats de données dans Excel en utilisant une bibliothèque C# ?

Lorsque vous définissez des formats de données dans Excel en utilisant IronXL, assurez-vous que la bibliothèque est correctement intégrée, vérifiez que les chaînes de format utilisées sont exactes et vérifiez toute exception survenant pendant le processus d'enregistrement du classeur. En outre, envisagez d'utiliser la propriété StringValue pour une saisie de données précise.

Chaknith Bin
Chaknith Bin
  Discutez maintenant avec l'équipe d'ingénierie
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il a une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, documentation et expérience globale.
Prêt à commencer?
Nuget Téléchargements 1,738,553 | Version: 2025.11 vient de sortir