当前位置：首页 > news >正文

Excel处理控件Spire.XLS系列教程：C# 设置 Excel 中的数字格式

news 来源：原创 2025/9/21 10:22:53

在 Excel 工作表中，原始数据通常显示为缺乏直观性的普通数字。通过设置数字格式，可以将这些数字转换成更容易理解的形式。例如，将销售额数据设置为货币格式，即添加货币符号和千位分隔符，可使所代表的金额一目了然。将市场份额数据格式化为百分比格式，可以清楚地显示各部分的比例，便于快速比较和分析。本文将介绍如何使用 Spire.XLS for .NET 通过 C# 设置 Excel 单元格中的数字格式 。

Spire.XLS for .NET试用下载

安装 Spire.XLS for .NET

E-iceblue旗下Spire是国产文档处理领域的优秀产品，支持国产化开发。首先，您需要将 Spire.XLS for .NET 包含的 DLL 文件作为引用添加到您的 .NET 项目中。DLL 文件可以从此链接下载，也可以通过 NuGet 安装。

PM> Install-Package Spire.XLS

Excel 数字格式中的符号

在 Excel 数字格式代码中，需要用到一些符号来定义数字的显示方式。下面是常用符号的详细解释：

符号	描述
0	必填数字占位符。如果数字的位数少于“0”的个数，Excel 会在数字前或后添加 0 以填满占位符
#	可选数字占位符。不显示无意义的零。
?	可选数字占位符。可以使具有不同小数位数的数字在小数点处对齐。
.	代表小数点。
,	代表千位分隔符。
;	用于分隔正值、负值、零值和文本值的数字格式的不同部分。
%	百分比符号。将数字乘以 100 并显示为百分比形式。
E - +	代表科学计数法符号。
$, €, ¥, etc.	代表相应的货币符号。
[Color]	用于指定数字的颜色。
Date/Time (yyyy, mmmm, mm, dd, hh, ss, AM/PM)	分别代表年、全月名、月、日、时、分、秒和 12 小时时钟标记。

C# 设置 Excel 中的数字格式

Spire.XLS for .NET 提供了用于设置单元格数值的 CellRange.NumberValue 属性和用于设置数字格式的 CellRange.NumberFormat 属性。具体步骤如下：

创建 Workbook 类的对象。
通过 Workbook.Worksheets[] 属性获取指定的工作表。
通过 Workbook.Range[] 属性获取指定的单元格。
通过 CellRange.Text 属性向指定单元格添加文本。
通过 CellRange.NumberValue 属性为指定单元格添加数值，然后通过 CellRange.NumberFormat 属性设置数字格式。
使用 Workbook.SaveToFile() 方法保存结果文件。

using Spire.Xls;namespace SetNumberFormat
{class Program{static void Main(string[] args){// 创建Workbook类的对象Workbook workbook = new Workbook();// 获取第一张工作表Worksheet sheet = workbook.Worksheets[0];// 在指定单元格中添加文本并设置单元格样式sheet.Range["B3"].Text = "输入";sheet.Range["C3"].Text = "数字格式";sheet.Range["D3"].Text = "输出";sheet.Range["E3"].Text = "备注";sheet.Range["B3:E3"].Style.Font.IsBold = true;sheet.Range["B3:E3"].Style.KnownColor = ExcelColors.SkyBlue;// 用零填充的数字sheet.Range["B4"].Text = "123";sheet.Range["C4"].Text = "0000";sheet.Range["D4"].NumberValue = 123;sheet.Range["D4"].NumberFormat = "0000";sheet.Range["E4"].Text = "用零填充的数字";// 带千位分隔符的两位数小数sheet.Range["B5"].Text = "1234.5678";sheet.Range["C5"].Text = "#,##0.00";sheet.Range["D5"].NumberValue = 1234.5678;sheet.Range["D5"].NumberFormat = "#,##0.00";sheet.Range["E5"].Text = "带千位分隔符的两位数小数";// 负数用红色表示sheet.Range["B6"].Text = "-1234.5678";sheet.Range["C6"].Text = "0;[Red]-0";sheet.Range["D6"].NumberValue = -1234.5678;sheet.Range["D6"].NumberFormat = "0;[Red]-0";sheet.Range["E6"].Text = "负数用红色表示";// 带一位小数的百分比sheet.Range["B7"].Text = "0.12345";sheet.Range["C7"].Text = "0.0%";sheet.Range["D7"].NumberValue = 0.12345;sheet.Range["D7"].NumberFormat = "0.0%";sheet.Range["E7"].Text = "带一位小数的百分比";// 带文本的数字sheet.Range["B8"].Text = "1234.5678";sheet.Range["C8"].Text = "\"Quantity: \"0";sheet.Range["D8"].NumberValue = 1234.5678;sheet.Range["D8"].NumberFormat = "\"数量: \"0";sheet.Range["E8"].Text = "带文本的数字";// 带货币符号的数字sheet.Range["B9"].Text = "1234.5678";sheet.Range["C9"].Text = "$#,##0.00";sheet.Range["D9"].NumberValue = 1234.5678;sheet.Range["D9"].NumberFormat = "$#,##0.00";sheet.Range["E9"].Text = "带货币符号的数字";// 科学记数法格式sheet.Range["B10"].Text = "1234.5678";sheet.Range["C10"].Text = "0.00E+00";sheet.Range["D10"].NumberValue = 1234.5678;sheet.Range["D10"].NumberFormat = "0.00E+00";sheet.Range["E10"].Text = "科学记数法";// 分数sheet.Range["B11"].Text = "0.5";sheet.Range["C11"].Text = "# ?/?";sheet.Range["D11"].NumberValue = 0.5;sheet.Range["D11"].NumberFormat = "# ?/?";sheet.Range["E11"].Text = "分数";// 日期sheet.Range["B12"].Text = "45930";sheet.Range["C12"].Text = "yyyy-MM-dd";sheet.Range["D12"].NumberValue = 45930;sheet.Range["D12"].NumberFormat = "yyyy-MM-dd";sheet.Range["E12"].Text = "日期";// 时间sheet.Range["B13"].Text = "0.5";sheet.Range["C13"].Text = "h:mm:ss AM/PM";sheet.Range["D13"].NumberValue = 0.5;sheet.Range["D13"].NumberFormat = "h:mm:ss AM/PM";sheet.Range["E13"].Text = "时间";// 设置单元格样式sheet.AllocatedRange.Style.Font.FontName = "Calibri";sheet.AllocatedRange.Style.Font.Size = 11;sheet.AllocatedRange.Style.HorizontalAlignment = HorizontalAlignType.Left;// 自适应列宽sheet.AutoFitColumn(2);sheet.AutoFitColumn(3);sheet.AutoFitColumn(4);sheet.AutoFitColumn(5);// 保存结果文件workbook.SaveToFile("Excel数字格式.xlsx", ExcelVersion.Version2016);}}
}

安装 Spire.XLS for .NET

Excel 数字格式中的符号

C# 设置 Excel 中的数字格式

相关文章：