[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Collapse]Office File API
  Demo Application
  Redistribution and Deployment
 [Collapse]Spreadsheet Document API
   Product Structure
   Getting Started
  [Expand]Spreadsheet Document
   Supported Formats
  [Collapse]Cell Basics
    Cell Data Types
    Dates and Times in Cells
    Error Types
    Cell Referencing
    Formatting Cells
  [Expand]Formulas
   Defined Names
   Data Binding
  [Expand]Pivot Tables
  [Expand]Charts and Graphics
  [Expand]Mail Merge
  [Expand]Examples
 [Expand]Word Processing Document API
 [Expand]PDF Document API
 [Expand]Excel Export Library
 [Expand]Snap Report API
 [Expand]Zip Compression and Archive API
 [Expand]Barcode Generation API
 [Expand]Unit Conversion API
 [Expand]API Reference
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Error Types

If a cell contains a formula that cannot be calculated correctly, the cell's value (Range.Value) is of the error type (the CellValue.IsError property value is true). To access information on an error contained in a cell, use the members of the ErrorValueInfo object returned by the CellValue.ErrorValue property. The ErrorValueInfo.Type returns the ErrorType enumeration member that specifies the error type, the ErrorValueInfo.Name property returns the error name displayed in a cell, and the ErrorValueInfo.Description property returns the cause of the error.

Error Type

Error Name

Error Description

Example

ErrorType.DivisionByZero

#DIV/0!

Division by zero!

cell.Formula = "= 10/0"

cell.Formula = "= A1/B2", the B2 cell is blank

ErrorType.Name

#NAME?

Function does not exist.

cell.Formula = "= FALS" - The function name used in the formula is not spelled correctly.

cell.Formula = "=SUM(A1B2)" - A colon (:) is missing in the cell range reference.

ErrorType.NotAvailable

#N/A

The value is not available to a function or formula.

cell.Formula = "= NA()"

cell.ArrayFormula = "=SUM(A1:A5*A1:B3)" - An array formula's arguments are arrays consisting of different numbers of elements.

ErrorType.Null

#NULL!

The specified intersection includes two ranges that do not intersect.

cell.Formula = "=SUM(A1:A5 E6:E8)" - The specified ranges do not intersect, so the sum cannot be calculated.

ErrorType.Number

#NUM!

Invalid numeric values in a formula or function.

cell.Formula = "=SQRT(-16)" - The square root of a negative number cannot be calculated.

ErrorType.Reference

#REF!

Cell reference is not valid.

A formula uses a reference to a cell, and then the column containing this cell is deleted:

cell.Formula = "=5+D2";

worksheet.Columns["D"].Delete();

ErrorType.Value

#VALUE!

The value used in the formula is of the wrong data type.

cell.Formula = @"= SUM(""text"", 6)" - The SUM function requires numeric arguments.

A formula refers to a blank cell that is not actually empty (it contains an empty string):

worksheet["A1"].Value = "";

cell.Formula = "= A1 + 5";

To fix the error in this case, specify an empty value for a cell as shown in the How to: Clear Cells of Content, Formatting, Hyperlinks and Comments example.

Expanded See Also

Is this topic helpful?​​​​​​​