ExcelException class sealed Errors

Base class for every exception thrown by excel_plus.

Catch this to handle any excel_plus-specific failure with one handler:

try {
  final excel = Excel.decodeBytes(bytes);
  // ...
} on ExcelException catch (e) {
  print('Could not process workbook: ${e.message}');
}

or narrow to a specific kind (ExcelArchiveException, ExcelFormatException, ExcelEncodeException, FormulaParseException).

This type is sealed: you can catch it, but it is not meant to be subclassed outside the package.

Note: invalid arguments you pass to the API (a negative cell index, an empty table name, an out-of-range row) still throw ArgumentError, the standard Dart type for programming errors. Those are bugs in the calling code, not ExcelExceptions.

Implemented types

• Exception

Implementers

• ExcelArchiveException
• ExcelEncodeException
• ExcelFormatException
• FormulaParseException

Properties

cause → Object?

The underlying error this one wraps, when available.

final

hashCode → int

The hash code for this object.

no setter, inherited

message → String

A human-readable description of what went wrong.

final

part → String?

The package part involved (e.g. xl/worksheets/sheet1.xml), when known.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

override

Operators

operator ==(Object other) → bool

The equality operator.

inherited