InvalidOperationException Class (System)

.NET Framework Class Library

InvalidOperationException Class

The exception that is thrown when a method call is invalid for the object's current state.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class InvalidOperationException _
    Inherits SystemException

Visual Basic (Usage)

Dim instance As InvalidOperationException

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class InvalidOperationException : SystemException

Visual C++

[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class InvalidOperationException : public SystemException

JScript

public class InvalidOperationException extends SystemException

Remarks

InvalidOperationException is used in cases when the failure to invoke a method is caused by reasons other than invalid arguments. For example, InvalidOperationException is thrown by:

MoveNext if objects of a collection are modified after the enumerator is created.
GetString if the resource set is closed before the method call is made.

If the method invocation failure is due to invalid arguments, then ArgumentException or one of its derived classes, ArgumentNullException or ArgumentOutOfRangeException, should be thrown instead.

The Ldflda Microsoft intermediate language (MSIL) instruction throws InvalidOperationException.

InvalidOperationException uses the HRESULT COR_E_INVALIDOPERATION, which has the value 0x80131509.

For a list of initial property values for an instance of InvalidOperationException, see the InvalidOperationException constructors.

Inheritance Hierarchy

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference

InvalidOperationException Members

Other Resources

Handling and Throwing Exceptions