Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 3.5
System Namespace
This page is specific to
Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:
.NET Framework Class Library
ObjectDisposedException Class

Updated: November 2007

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
J#
/** @attribute SerializableAttribute */ 
/** @attribute ComVisibleAttribute(true) */
public class ObjectDisposedException extends 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 );
   }

}


J#
import System.*;  
import System.IO.*;

public class ObjectDisposedExceptionTest
{
    public static void main(String[] args)
    {
        MemoryStream ms = new MemoryStream(16);
        ms.Close();
        try {
            ms.ReadByte();
        }
        catch (ObjectDisposedException e) {
            Console.WriteLine("Caught: {0}", e.get_Message());
        }
    } //main
} //ObjectDisposedExceptionTest

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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, 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

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: 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   |  
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.
Tags What's this?: Add a tag
Flag as ContentBug
Typical Usage      David M. Kean - MSFT   |   Edit   |  

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

[C#]



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

}
Tags What's this?: Add a tag
Flag as ContentBug
Processing
© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker