Share via


Exception Hierarchy

Microsoft Silverlight will reach end of support after October 2021. Learn more.

There are two types of exceptions: exceptions generated by an executing program, and exceptions generated by the common language runtime. In addition, there is a hierarchy of exceptions that can be thrown by either an application or the runtime.

Exception is the base class for exceptions.

Most exceptions that derive directly from Exception add no functionality to the Exception class. For example, the InvalidCastException Class hierarchy is as follows:

Object    Exception       SystemException          InvalidCastException

The runtime throws the appropriate derived class of SystemException when errors occur. These errors result from failed runtime checks (such as array out-of-bound errors), and can occur during the execution of any method. If you are designing an application that creates new exceptions, you should derive those exceptions from the Exception class. It is not recommended that you catch a SystemException, nor is it good programming practice to throw a SystemException in your application.

The most severe exceptions — those thrown by the runtime or in nonrecoverable conditions — include ExecutionEngineException, StackOverflowException, and OutOfMemoryException.

Hierarchy of Runtime Exceptions

The runtime has a base set of exceptions deriving from SystemException that it throws when executing individual instructions. The following table hierarchically lists the standard exceptions provided by the runtime and the conditions under which you should create a derived class.

Exception type

Base type

Description

Example

Exception

Object

Base class for all exceptions.

None (use a derived class of this exception).

SystemException

Exception

Base class for all runtime-generated errors.

None (use a derived class of this exception).

IndexOutOfRangeException

SystemException

Thrown by the runtime only when an array is indexed improperly.

Indexing an array outside its valid range:

arr[arr.Length+1]

NullReferenceException

SystemException

Thrown by the runtime only when a null object is referenced.

object o = null;

o.ToString();

AccessViolationException

SystemException

Thrown by the runtime only when invalid memory is accessed.

Occurs when interoperating with unmanaged code or unsafe managed code, and an invalid pointer is used.

InvalidOperationException

SystemException

Thrown by methods when in an invalid state.

Calling Enumerator.GetNext() after removing an Item from the underlying collection.

ArgumentException

SystemException

Base class for all argument exceptions.

None (use a derived class of this exception).

ArgumentNullException

ArgumentException

Thrown by methods that do not allow an argument to be null.

String s = null;

"Calculate".IndexOf (s);

ArgumentOutOfRangeException

ArgumentException

Thrown by methods that verify that arguments are in a given range.

String s = "string";

s.Chars[9];

ExternalException

SystemException

Base class for exceptions that occur or are targeted at environments outside the runtime.

None (use a derived class of this exception).

ComException

ExternalException

Exception encapsulating COM HRESULT information.

Used in COM interop.

SEHException

ExternalException

Exception encapsulating Win32 structured exception handling information.

Used in unmanaged code interop.