ReoGrid 通过数据格式化器格式化单元格的显示和解析。支持的格式类型包括数字、日期、百分比、货币、文本和自定义格式化器。

命名空间

using unvell.ReoGrid.DataFormat;

应用数据格式

在工作表上使用 SetRangeDataFormat：

var sheet = reoGridControl.CurrentWorksheet;

sheet.SetRangeDataFormat("A1:B2", CellDataFormatFlag.Number,
    new NumberDataFormatter.NumberFormatArgs
    {
        DecimalPlaces = 4,
        NegativeStyle = NumberDataFormatter.NumberNegativeStyle.RedBrackets,
        UseSeparator = true,
    });

支持撤销：

reoGridControl.DoAction(new SetRangeDataFormatAction("A1:B2",
    CellDataFormatFlag.Number,
    new NumberDataFormatter.NumberFormatArgs { DecimalPlaces = 2 }));

快速测试：

sheet["B2"] = 12345;
sheet["C2"] = 12345.67890;
sheet["B3"] = -1234;
sheet["C3"] = -1234.56789;

CellDataFormatFlag 枚举

数字格式

数字格式支持千位分隔符、小数位数和负数样式。

sheet.SetRangeDataFormat("A1:E7", CellDataFormatFlag.Number,
    new NumberDataFormatter.NumberFormatArgs
    {
        DecimalPlaces = 4,
        UseSeparator = true,
    });

NumberFormatArgs 属性

NumberNegativeStyle 枚举（标志位）

这是一个标志位枚举 — 值可以使用 | 组合：

NegativeStyle = NumberDataFormatter.NumberNegativeStyle.Brackets | NumberDataFormatter.NumberNegativeStyle.Red

负数示例

sheet.SetRangeDataFormat("B2", CellDataFormatFlag.Number,
    new NumberDataFormatter.NumberFormatArgs
    {
        DecimalPlaces = 3,
        NegativeStyle = NumberDataFormatter.NumberNegativeStyle.RedBrackets,
        UseSeparator = true,
    });

sheet["B2"] = -12345.67;

日期时间格式

使用标准 .NET 日期时间模式指定区域设置和格式模式：

sheet.SetRangeDataFormat(RangePosition.EntireRange, CellDataFormatFlag.DateTime,
    new DateTimeDataFormatter.DateTimeFormatArgs
    {
        CultureName = "en-US",
        Format = "yyyy/MM/dd",
    });

DateTimeFormatArgs 属性

注意： DateTimeFormatArgs 是一个 struct，不是类。

百分比格式

值以百分比形式显示。使用 NumberFormatArgs 进行配置：

sheet.SetRangeDataFormat(RangePosition.EntireRange, CellDataFormatFlag.Percent,
    new NumberDataFormatter.NumberFormatArgs
    {
        DecimalPlaces = 2,
    });

单元格值 0.5 显示为 50.00%。

货币格式

货币格式在数字格式的基础上扩展，将货币符号放置在值的前面或后面。

sheet.SetRangeDataFormat("B2", CellDataFormatFlag.Currency,
    new CurrencyDataFormatter.CurrencyFormatArgs
    {
        CultureEnglishName = "en-US",
        DecimalPlaces = 2,
        UseSeparator = true,
        PrefixSymbol = "$",
    });

sheet["B2"] = 1234;

CurrencyFormatArgs 属性

CurrencyFormatArgs 继承自 NumberFormatArgs 并添加了货币特定属性：

带空格的前缀

sheet.SetRangeDataFormat("B2", CellDataFormatFlag.Currency,
    new CurrencyDataFormatter.CurrencyFormatArgs
    {
        CultureEnglishName = "en-US",
        DecimalPlaces = 2,
        UseSeparator = true,
        PrefixSymbol = "$ ",   // 注意末尾的空格
    });

后缀符号

sheet.SetRangeDataFormat("B2", CellDataFormatFlag.Currency,
    new CurrencyDataFormatter.CurrencyFormatArgs
    {
        CultureEnglishName = "en-US",
        DecimalPlaces = 2,
        UseSeparator = true,
        PostfixSymbol = " USD",
    });

文本格式

使用 Text 将值保持为原始字符串，不进行格式化：

sheet.SetRangeDataFormat(RangePosition.EntireRange, CellDataFormatFlag.Text, null);

单元格数据格式属性

访问单个单元格上的格式：

var cell = sheet.Cells["A1"];

// 获取当前格式
CellDataFormatFlag format = cell.DataFormat;
object formatArgs = cell.DataFormatArgs;

// 设置格式
cell.SetDataFormat(CellDataFormatFlag.Number,
    new NumberDataFormatter.NumberFormatArgs { DecimalPlaces = 3 });

自定义数据格式化器

实现 IDataFormatter 以创建自定义格式化器：

public interface IDataFormatter
{
    string FormatCell(Cell cell);
    bool PerformTestFormat();
}

使用 CellDataFormatFlag.Custom 应用：

sheet.SetRangeDataFormat("A1", CellDataFormatFlag.Custom, myFormatterArgs);

// 或直接在单元格上设置
cell.CustomDataFormatter = new MyCustomFormatter();

详见 自定义数据格式 了解详细示例。

相关主题

• 单元格 — 单元格属性和数据访问
• 自定义数据格式 — 创建自定义格式化器
• 单元格编辑 — 输入行为设置
• 设置 — 自动格式化设置