1. IronXL
  2. 操作指南
  3. 设置单元格数据格式
如何在 Excel 中设置单元格数据格式

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

Chaknith Bin
Chaknith Bin
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

此示例展示了使用 IronXL 的 API 创建新的 Excel 工作簿并将内置格式应用于特定单元格是多么容易。 只需几秒钟即可启动并运行，无需任何互操作依赖项——只需设置"FormatString"并保存即可。

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

  1. 使用 NuGet 包管理器安装 IronXL

    PM > Install-Package IronXL.Excel

  2. 复制并运行这段代码。

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

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

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

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

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


设置单元格数据格式示例

可以通过单元格和单元格区域访问FormatString属性。 因此，可以为单个单元格、列、行和任何选定范围设置数据格式。

: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 中单元格值前加上撇号。

: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.Formatting.BuiltinFormats类访问这些字符串，用于格式化 Excel 单元格。 这样您就可以自定义数据在 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 分钟。 以下是可用的格式类型：

所有可用数据格式

描述

  • General ：默认格式，按原样显示数字，不进行任何特定格式设置。
  • Duration1 ：以分钟和秒为单位显示持续时间值，格式为"mm:ss"。在 Value 属性中输入的数字将被视为天数。
  • 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 ：将文本值格式化为纯文本，例如"@"（不应用任何特定格式）。

常见问题解答

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

您可以通过访问工作表并设置单元格的FormatString属性，使用IronXL在Excel中设置单元格数据格式。这允许自定义数据的显示方式，如数字、日期和时间，而无需使用Interop。

使用C#库进行Excel数据格式化有什么好处？

使用像IronXL这样的C#库进行Excel数据格式化，使您能够以编程方式控制数据的外观，增强可读性，确保数据准确性，并避免使用Interop的复杂性。它简化了如设置数字格式、日期和自定义格式等任务。

如何使用C#在Excel单元格中应用自定义数字格式？

要使用IronXL对单元格应用自定义数字格式，请加载Excel工作簿，访问工作表，并将单元格的FormatString属性设置为所需的自定义格式。例如，要将数字显示为百分比，请使用sheet["A1"].FormatString = "0.00%"。

我可以使用C#库保留Excel单元格中的前导零吗？

可以，使用IronXL时，可以通过在设置单元格的值时使用StringValue属性来保留前导零。这种方法可以防止自动转换并保留单元格中的前导零。

如何使用C#将Excel单元格格式化为会计样式？

要使用IronXL将Excel单元格格式化为会计样式，利用BuiltinFormats类。例如，您可以通过sheet["C3"].FormatString = IronXL.Formatting.BuiltinFormats.Accounting2将两个小数位的会计格式应用到单元格。

C#库中的Excel有哪些预定义的数据格式？

IronXL提供了如会计、持续时间、时间、日期、分数、科学、百分比、货币和数字等预定义的数据格式。这些内置格式简化了Excel电子表格中数据呈现的自定义。

如何使用C#在Excel中将负货币值显示为红色？

要使用IronXL将负货币值显示为红色，设置FormatString属性为包含红色负数的货币格式，如Currency0Red或Currency2Red。例如：sheet["B4"].FormatString = IronXL.Formatting.BuiltinFormats.Currency2Red。

IronXL中的Number0和Number2格式有何不同？

在IronXL中，Number0格式不显示小数位，而Number2格式显示两个小数位数。 这些格式有助于定制Excel工作表中数据的精确度。

如何在使用C#格式化Excel工作簿后保存更改？

在用IronXL格式化Excel工作簿后，要保存更改，请在WorkBook对象上使用SaveAs方法。指定所需的文件名和格式来保存更新的工作簿。

在使用C#库设置Excel数据格式时，您有哪些故障排除技巧？

在使用IronXL设置Excel数据格式时，确保库已正确集成，验证所用的格式字符串是否准确，并检查工作簿保存过程中的任何异常。此外，考虑使用StringValue属性进行精确的数据输入。

Chaknith Bin
Chaknith Bin
  立即与工程团队聊天
软件工程师
Chaknith 在 IronXL 和 IronBarcode 工作。他在 C# 和 .NET 方面有着深厚的专业知识，帮助改进软件并支持客户。他从用户互动中获得的见解有助于更好的产品、文档和整体体验。
准备开始了吗？
Nuget 下载 1,738,553 | Version: 2025.11 刚刚发布