Formatting.NumberFormat Property
Specifies a number format for a numeric cell value in the invariant culture.
Namespace: DevExpress.Spreadsheet
Assembly: DevExpress.Spreadsheet.v25.1.Core.dll
NuGet Package: DevExpress.Spreadsheet.Core
#Declaration
#Property Value
| Type | Description |
|---|---|
| String | The number format in the invariant (English) culture. |
#Remarks
The Spreadsheet uses Microsoft Excel number formats to display cell numbers as percentage, decimal, currency, accounting, and date/time values.
To apply a number format to a cell, use the Cell object’s NumberFormat property.
To apply a number format to a cell range, call the CellRange.BeginUpdateFormatting method for this range, set the NumberFormat property of the returned Formatting object, and then call the CellRange.EndUpdateFormatting method.
To share the same number format between multiple cells, create or modify a cell style with the NumberFormat property specified. Use the CellRange.Style property to assign this style to cells.
The NumberFormat property allows you to use both the built-in and custom number formats. Refer to the following example for details: How to: Specify Number or Date Format for Cell Content.
You can also use the Formatting.NumberFormatLocal property to obtain or specify a number format based on the local culture defined by the DocumentOptions.Culture property.
#Example
This example demonstrates how to use different number formats to display numeric values in cells.
// Display 111 as 111.
worksheet.Cells["A1"].Value = 111;
worksheet.Cells["A1"].NumberFormat = "#####";
// Display 222 as 00222.
worksheet.Cells["B1"].Value = 222;
worksheet.Cells["B1"].NumberFormat = "00000";
// Display 12345678 as 12,345,678.
worksheet.Cells["C1"].Value = 12345678;
worksheet.Cells["C1"].NumberFormat = "#,#";
// Display .126 as 0.13.
worksheet.Cells["D1"].Value = .126;
worksheet.Cells["D1"].NumberFormat = "0.##";
// Display 74.4 as 74.400.
worksheet.Cells["E1"].Value = 74.4;
worksheet.Cells["E1"].NumberFormat = "##.000";
// Display 1.6 as 160.0%.
worksheet.Cells["F1"].Value = 1.6;
worksheet.Cells["F1"].NumberFormat = "0.0%";
// Display 4321 as $4,321.00.
worksheet.Cells["G1"].Value = 4321;
worksheet.Cells["G1"].NumberFormat = "$#,##0.00";
// Display 8.75 as 8 3/4.
worksheet.Cells["H1"].Value = 8.75;
worksheet.Cells["H1"].NumberFormat = "# ?/?";
#Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the NumberFormat property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.