如何使用 IronXL 在 C# 中设置单元格数据格式

Updated: 2026年6月4日

IronXL通过设置单元格或范围上的FormatString属性来使用内置数据格式对Excel单元格格式化，例如货币、百分比、日期和自定义数字格式，且无需Interop依赖。

快速入门：一行代码为单个单元格应用内置格式

本示例展示了如何使用 IronXL.Excel 的 API 创建一个新的 Excel 工作簿并将内置格式应用到特定单元格。无需Interop依赖——只需设置FormatString并保存。

1Install IronXL with NuGet Package Manager
PM > Install-Package IronXL.Excel
```
Install-Package IronXL.Excel
```

2复制并运行这段代码。

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

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

3部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronXL

最小工作流程（5 个步骤）

下载 C# 库以设置数据格式
打开现有或创建新的 Excel 电子表格
将单元格、列、行或区域的FormatString属性设置为所需的数据格式
使用BuiltinFormats类的内置数据格式
以各种文件类型导出编辑后的电子表格

如何在 Excel 中设置单元格数据格式？

FormatString属性可通过单元格和范围访问。因此，可以为单个单元格、列、行和任何选定范围设置数据格式。当您需要在没有 Interop 的情况下用 C# 处理 Excel 文件时，这种灵活性使 IronXL 特别强大。

数据格式对于在电子表格中清晰呈现信息至关重要。无论是创建带有货币值的财务报告、带有精确小数位的科学数据，还是基于日期的分析，正确的格式化都能确保您的数据既可读又专业。 IronXL.Excel 通过直接的 API 提供对 Excel 格式化引擎的直接访问，从而简化了这一过程。

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

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

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

显示格式化单元格的 Excel 电子表格：不同显示格式的百分比、数字和日期/时间值

如何在不转换的情况下将单元格值设置为字符串？

在IronXL中设置值时，使用Value以直接将精确值分配给单元格而不会自动转换。这就好比在 Excel 中将撇号放在单元格值之前。在处理产品代码、电话号码或其他应保留为文本的数据时，这种技巧尤其有用。有关更高级的字符串操作，请查看如何在 .NET 中写入 Excel 值。

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

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

' Assign value as string
workSheet("A1").StringValue = "4402-12"

' Assign value as string
workSheet("A1").StringValue = "4402-12"

如何在 IronXL 中使用内置格式？

IronXL库提供了一系列预定义的格式字符串，可通过IronXL.Formatting.BuiltinFormats类访问以格式化Excel单元格。这样您就可以自定义数据在 Excel 表格中的显示方式。这些内置格式涵盖了最常见的业务场景，并与所有 Excel 版本兼容。

当以编程方式创建电子表格时，应用一致的格式对于在整个文档中保持专业标准至关重要。 BuiltinFormats类提供30多种与Excel标准格式选项匹配的预配置格式样式。

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

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

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

有哪些内置数据格式？

对于Duration类型，输入值以天为单位表示。例如，1 天等于 24 小时，1.05 天等于 25 小时 12 分钟。当使用涉及时间跟踪或项目管理的 Excel 数据时，这一点尤其有用。以下是可用的格式类型：

每种格式类型的作用是什么？

General：默认格式显示无特定格式的数字。
Duration1：显示分钟和秒的持续时间，例如"mm:ss"。
Duration2：显示小时、分钟和秒的持续时间，例如"[h]:mm:ss"。
Duration3：显示分钟、秒和毫秒的持续时间，例如"mm:ss.0"。
Accounting0：无小数的会计格式，负数用括号表示，如"#,##0_);(#,##0)。"
Accounting0Red：无小数的会计格式，负数用红色表示，如"#,##0_);Red。"
Accounting2：含两位小数的会计格式，负数用括号表示，如"#,##0.00;(#,##0.00)。"
Accounting2Red：含两位小数的会计格式，负数用红色表示，如"#,##0.00_);Red。"
Time1：12小时格式，含AM/PM，如"h:mm AM/PM"。
Time2：含秒数的12小时格式和AM/PM，如"h:mm:ss AM/PM"。
Time3：无秒的24小时格式，如"h:mm"。
Time4：含秒的24小时格式，如"h:mm:ss"。
ShortDate：简短日期格式，如"m/d/yy"。
ShortDateAndTime：简短日期和时间格式如"m/d/yy h:mm"。
LongDate1：含月份、日期、年份的长日期，如"d-mmm-yy"。
LongDate2：含天和缩写月份的长日期，如"d-mmm"。
LongDate3：含缩写月份和年份的长日期，如"mmm-yy"。
Fraction1：一位小数的分数值，如"# ?/?"。
Fraction2：两位小数的分数值，如"# ??/??"。
Scientific1：一位小数的科学记数法，如"##0.0E+0"。
Scientific2：含两位小数的科学记数法，如"0.00E+00"。
Percent：无小数的百分比，如"0%"。
Percent2：含两位小数的百分比，如"0.00%"。
Currency0：无小数的货币，负数用括号表示，如"$#,##0_);($#,##0)。"
Currency0Red：无小数的货币，负数用红色表示，如"$#,##0_);Red。"
Currency2：含两位小数的货币，负数用括号表示，如"$#,##0.00;($#,##0.00)。"
Currency2Red：含两位小数的货币，负数用红色表示，如"$#,##0.00_);Red。"
Thousands0：带千位分隔符的数字，无小数如"#,##0"。
Thousands2：带千位分隔符和两位小数的数字，如"#,##0.00"。
Number0：无小数的数字，如"0"。
Number2：含两位小数的数字，如"0.00"。
Text：纯文本格式如"@"。

Excel 中的数据格式和数字格式控制单元格中数字、日期、时间和其他数据的显示方式，从而提高可读性并确保数据的准确性。通过数据格式，您可以将信息以特定格式（例如百分比或货币）呈现。同样，数字格式允许您自定义小数位数和显示选项。

如何将多种格式应用于不同的范围？

在实际应用中，您经常需要对电子表格的各个部分应用不同的格式。本示例演示了如何格式化具有多种数据类型的财务报告。当用 C# 从数据库或其他数据源导出到 Excel 时，这种方法尤其有用：

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

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

Imports IronXL
Imports IronXL.Formatting
Imports System

' Create a financial report with multiple formats
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As 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
Dim expenseRange As IronXL.Range = workSheet("B8:B12")
expenseRange.FormatString = BuiltinFormats.Accounting2Red

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

Imports IronXL
Imports IronXL.Formatting
Imports System

' Create a financial report with multiple formats
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As 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
Dim expenseRange As IronXL.Range = workSheet("B8:B12")
expenseRange.FormatString = BuiltinFormats.Accounting2Red

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

本示例展示了不同格式类型如何结合创建专业的财务文档。对于更高级的格式化选项，包括条件格式化，您可以进一步扩展这些概念。

在处理大型数据集或以编程方式创建报告时，格式的一致性至关重要。 IronXL.Excel 的格式化系统与数学函数和编辑公式等其他功能无缝集成，使您可以创建完全自动化的报告解决方案。

对于从 Office Interop 迁移或寻求更好性能的开发人员来说，IronXL 的格式化系统具有显著优势。与传统方法不同，您可以高效地格式化数千个单元格，而无需 COM 交互开销。要了解有关 Excel 自动化最佳实践的更多信息，请浏览我们全面的 Excel 文档。

常见问题解答

如何在不使用 Interop 的情况下用 C# 格式化 Excel 单元格？

IronXL.Excel 提供了一种无需 Interop 依赖性即可格式化 Excel 单元格的简单方法。你可以在单元格或范围上使用 FormatString 属性来应用内置格式，如货币、百分比、日期和自定义数字格式。只需用 IronXL 创建或打开一个工作簿，然后将 FormatString 属性设置为所需格式即可。

在单元格中应用货币格式化的最快方法是什么？

有了 IronXL，您只需一行代码就能应用货币格式。创建工作簿后，只需使用：book.DefaultWorkSheet["B2"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2; 即可在单元格 B2 中应用小数点后两位的内置货币格式。

我可以同时格式化多个单元格吗？

是的，IronXL 允许您通过 FormatString 属性格式化单个单元格、整列、整行或任何选定的范围。这种灵活性使您可以轻松地在 Excel 电子表格中的多个单元格中应用一致的格式，而无需逐一遍历每个单元格。

如何防止在设置单元格值时自动转换数据？

IronXL 提供了 StringValue 属性，无需自动转换即可将单元格值设置为字符串。与其使用 Value 属性，不如使用 StringValue 为单元格分配准确的值。这与在 Excel 中将撇号放在单元格值之前的效果类似，对于产品代码、电话号码或其他应保留为文本的数据尤为有用。

有哪些内置格式选项？

IronXL 通过 IronXL.Formatting.BuiltinFormats 类提供了全面的预定义格式字符串集合。其中包括各种货币格式、日期和时间格式、百分比显示、科学记数法和自定义数字格式，让您可以自定义 Excel 电子表格中的数据显示方式。

我需要安装 Microsoft Excel 才能使用单元格格式化功能吗？

不，IronXL.Excel 可独立运行，无需 Microsoft Excel 或 Interop 依赖项。该库包含自己的格式化引擎，可直接处理 Excel 文件，因此非常适合服务器环境或未安装 Excel 的系统。

Does IronXL offer any performance benefits over Interop for Excel formatting?

IronXL provides significant performance improvements over traditional Interop by eliminating COM interop overhead, allowing efficient formatting of thousands of cells without relying on Office components.

How does IronXL's formatting enhance Excel reporting in C#?

IronXL’s formatting system integrates seamlessly with math functions and formula edits, making it invaluable for creating fully automated Excel reports programmatically.

What is a quick way to start using IronXL for formatting Excel cells?

To get started with IronXL, download the C# library, create a new or open an existing Excel worksheet, set the `FormatString` property to the desired format, and export your edited spreadsheet.

How does IronXL support data format customization?

Besides built-in formats, IronXL allows you to define custom formats using the `FormatString` property, providing flexibility when presenting specific types of data in Excel cells.