Gets or sets the number format which indicates how to format and render the numeric value of a cell.
Default value is General.
If set to , number format will be resolved from referenced workbook style.
Custom number format has to be in invariant culture format.
For more information on number format strings consult Microsoft Excel documentation.
Conceptually, cell formatting is divided into following groups:
Additional CellStyle properties not associated with any formatting group are:
Cell formatting group (Number, Alignment, Font, Border, Fill or Protection) (and its associated properties) is resolved from referenced workbook (master) style, unless cell formatting group or its associated property is modified.
Cell formatting is available for one or more cells through Style property which is available on ExcelCell and CellRange types. Cell formatting specified on ExcelColumn and ExcelRow types through Style property is simply propagated to cell formatting of its Cells.
For performance reasons, cell formatting on CellRange is resolved based just on its top-left cell formatting, except borders which are resolved based on corner cells depending on border side.
Setting cell formatting property on CellRange is propagated to each cell in a range.
If modifying multiple formatting properties of a CellRange, without preserving unmodified formatting properties, preferable way is to create new instance of CellStyle, make modifications on it, and assign it to Style property of that range.
GemBox.Spreadsheet internally takes care not to allocate unnecessary cells when formatting a range of cells (for example, when formatting all worksheet cells) and to cache formatting information of equally formatted cells, at the appropriate time, to reduce memory footprint.
Following code demonstrates number formatting:
// 'Number' formatting group cells["B3"].Value = "NumberFormat"; cells["C3"].Value = 1234; cells["C3"].Style.NumberFormat = "#.##0,00 [$Krakozhian Money Units]";
' 'Number' formatting group cells("B3").Value = "NumberFormat" cells("C3").Value = 1234 cells("C3").Style.NumberFormat = "#.##0,00 [$Krakozhian Money Units]"