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

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

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

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

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

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

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronXL.Excel

    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. 以各种文件类型导出编辑后的电子表格


如何在 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");
$vbLabelText   $csharpLabel
显示格式化单元格的 Excel 电子表格：不同显示格式的百分比、数字和日期/时间值

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

在IronXL中设置值时，使用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";
$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");
$vbLabelText   $csharpLabel

有哪些内置数据格式？

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

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：带有AM/PM的12小时制格式，如"h:mm AM/PM"。
  • Time2：带有秒和AM/PM的12小时制格式，如"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");
$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
  立即与工程团队聊天
技术作家

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

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

准备开始了吗？
Nuget 下载 1,909,201 | 版本: 2026.3 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronXL.Excel
运行示例 观看您的数据变成电子表格。