ObjectDisposedException Class
.NET Framework Class Library
ObjectDisposedException Class

The exception that is thrown when an operation is performed on a disposed object.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
Visual Basic (Declaration)
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class ObjectDisposedException _
    Inherits InvalidOperationException
Visual Basic (Usage)
Dim instance As ObjectDisposedException
C#
[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ObjectDisposedException : InvalidOperationException
Visual C++
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class ObjectDisposedException : public InvalidOperationException
JScript
public class ObjectDisposedException extends InvalidOperationException

The following example demonstrates an error that causes the ObjectDisposedException exception to be thrown.

Visual Basic
Imports System
Imports System.IO

Public Class ObjectDisposedExceptionTest

   Public Shared Sub Main()
      Dim ms As New MemoryStream(16)
      ms.Close()
      Try
         ms.ReadByte()
      Catch e As ObjectDisposedException
         Console.WriteLine("Caught: {0}", e.Message)
      End Try
   End Sub 'Main
End Class 'ObjectDisposedExceptionTest
C#
using System;
using System.IO;

public class ObjectDisposedExceptionTest 
{
   public static void Main()
   {     
      MemoryStream ms = new MemoryStream(16);
      ms.Close();
      try 
      {
         ms.ReadByte();
      } 
      catch (ObjectDisposedException e) 
      {
         Console.WriteLine("Caught: {0}", e.Message);
      }
   }
}
Visual C++
using namespace System;
using namespace System::IO;
int main()
{
   MemoryStream^ ms = gcnew MemoryStream( 16 );
   ms->Close();
   try
   {
      ms->ReadByte();
   }
   catch ( ObjectDisposedException^ e ) 
   {
      Console::WriteLine( "Caught: {0}", e->Message );
   }

}

This code produces the following output:

Caught:
  Cannot access a closed Stream.
System..::.Object
  System..::.Exception
    System..::.SystemException
      System..::.InvalidOperationException
        System..::.ObjectDisposedException
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

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.

.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
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Do not catch this exception      David M. Kean - MSFT   |   Edit   |   Show History
Despite the examples above, you should never actually catch this exception. It is thrown to indicate the misuse of a class and therefore implies a bug in the calling code.
Typical Usage      David M. Kean - MSFT   |   Edit   |   Show History

The typical usage of this type is something like the following:

[C#]



private void CheckDisposed()
{
throw new ObjectDisposedException(GetType().FullName);

}
Processing
Page view tracker