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

Curtis Chau

已更新:2026年1月10日

Translated

View the article in English

IronXL.Excel 可通过在单元格或范围上设置 FormatString 属性，使用内置数据格式（如货币、百分比、日期和自定义数字格式）对 Excel 单元格进行格式化，而无需 Interop 依赖性。

快速入门：在一行中将内置格式应用于单个单元格

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

使用 NuGet 包管理器安装 IronXL

PM > Install-Package IronXL.Excel

复制并运行这段代码。

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

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

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

免费试用30天

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

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

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

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

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

: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

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

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

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

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

当以编程方式创建电子表格时，应用一致的格式对于在整个文档中保持专业标准至关重要。 BuiltinFormats 类提供了 30 多种预配置格式模式，与 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

有哪些内置数据格式？

对于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"。
百分比：不含小数点的百分比，如 "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"。
文本：纯文本格式，如"@"。

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

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

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

/* :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");

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

$vbLabelText $csharpLabel

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

在处理大型数据集或以编程方式创建报告时，格式的一致性至关重要。 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 的系统。

Curtis Chau

立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？

Nuget 下载 1,846,091 | 版本: 2026.2 刚刚发布

查看许可证

客户亮点：

开发者焦点：

网络研讨会：

开始免费 30 天试用

本页内容

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

立即开始使用 NuGet 创建 PDF 文件：

使用 NuGet 包管理器安装 IronXL

复制并运行这段代码。

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

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

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

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

有哪些内置数据格式？

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

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

常见问题解答

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

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

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

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

有哪些内置格式选项？

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

开始免费 30 天试用

本页内容

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

立即开始使用 NuGet 创建 PDF 文件：

使用 NuGet 包管理器安装 IronXL

复制并运行这段代码。

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

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

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

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

有哪些内置数据格式？

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

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

常见问题解答

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

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

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

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

有哪些内置格式选项？

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

免费获取

下一步：开始免费 30 天试用

下一步：开始免费 30 天试用

深受全球数百万工程师信赖