ObjectDisposedException Classe

Definição

public ref class ObjectDisposedException : InvalidOperationException

public class ObjectDisposedException : InvalidOperationException

[System.Serializable]
public class ObjectDisposedException : InvalidOperationException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ObjectDisposedException : InvalidOperationException

type ObjectDisposedException = class
    inherit InvalidOperationException

[<System.Serializable>]
type ObjectDisposedException = class
    inherit InvalidOperationException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ObjectDisposedException = class
    inherit InvalidOperationException

Public Class ObjectDisposedException
Inherits InvalidOperationException

Herança

Object

Exception

InvalidOperationException

ObjectDisposedException

Herança

Object

Exception

SystemException

InvalidOperationException

ObjectDisposedException

Atributos

SerializableAttribute ComVisibleAttribute

Exemplos

O exemplo seguinte demonstra um erro que faz com que a ObjectDisposedException exceção seja lançada.

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);
      }
   }
}

open System
open System.IO

let ms = new MemoryStream 16
ms.Close()
try
    ms.ReadByte()
    |> ignore
with :? ObjectDisposedException as e ->
   printfn $"Caught: {e.Message}"

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
End Class

Este código gera o seguinte resultado:

Caught:
  Cannot access a closed Stream.

Observações

Um ObjectDisposedException é lançado quando tentas aceder a um membro de um objeto que implementa a IDisposable interface ou IAsyncDisposable interface, e esse objeto foi eliminado. Normalmente, esta exceção é causada por uma das seguintes condições:

• Chamaste o Dispose método de um IDisposable objeto (ou o método de um IDisposableAsync objetoDisposeAsync), e estás a tentar aceder a um membro da instância que recebe ou define o estado do objeto. O exemplo seguinte ilustra o ObjectDisposedException que é lançado quando tenta reiniciar a frequência das notificações do temporizador depois de chamar o Timer.Dispose método.

  using System;
  using System.Threading;
  
  public class Example
  {
     public static void Main()
     {
        Timer t = new Timer(TimerNotification, null,
                           100, Timeout.Infinite);
        Thread.Sleep(2000);
        t.Dispose();
  
        t.Change(200, 1000);
        Thread.Sleep(3000);
     }
  
     private static void TimerNotification(Object obj)
     {
        Console.WriteLine("Timer event fired at {0:F}", DateTime.Now);
     }
  }
  // The example displays output like the following:
  //    Timer event fired at Monday, July 14, 2014 11:54:08 AM
  //
  //    Unhandled Exception: System.ObjectDisposedException: Cannot access a disposed object.
  //       at System.Threading.TimerQueueTimer.Change(UInt32 dueTime, UInt32 period)
  //       at Example.Main()
  

  open System
  open System.Threading
  
  let timerNotification _ =
      printfn $"Timer event fired at {DateTime.Now:F}"
  
  let t = new Timer(timerNotification, null, 100, Timeout.Infinite)
  Thread.Sleep 2000
  t.Dispose()
  
  t.Change(200, 1000)
  |> ignore
  Thread.Sleep 3000
  
  // The example displays output like the following:
  //    Timer event fired at Monday, July 14, 2014 11:54:08 AM
  //
  //    Unhandled Exception: System.ObjectDisposedException: Cannot access a disposed object.
  //       at System.Threading.TimerQueueTimer.Change(UInt32 dueTime, UInt32 period)
  //       at <StartupCode$fs>.main()
  

  Imports System.Threading
  
  Module Example
     Public Sub Main()
        Dim t As New Timer(AddressOf TimerNotification, Nothing, 
                           100, Timeout.Infinite)
        Thread.Sleep(2000)
        t.Dispose()
        
        t.Change(200, 1000)                   
        Thread.Sleep(3000)
     End Sub
  
     Private Sub TimerNotification(obj As Object)
        Console.WriteLine("Timer event fired at {0:F}", Date.Now)
     End Sub
  End Module
  ' The example displays output like the following:
  '    Timer event fired at Monday, July 14, 2014 11:54:08 AM
  '    
  '    Unhandled Exception: System.ObjectDisposedException: Cannot access a disposed object.
  '       at System.Threading.TimerQueueTimer.Change(UInt32 dueTime, UInt32 period)
  '       at Example.Main()
  

• Chamaste o Close método de um objeto e estás a tentar aceder a um membro da instância que recebe ou define o estado do objeto. Frequentemente, o Close método fornece a implementação IDisposable.Dispose pública do método por parte de um tipo. O mesmo se aplica a CloseAsync e <xref:System.IAsyncDisposable.DisposeAsync*?displayProperty=nameWithType>.

• Já chamaste um objeto Dispose ou DisposeAsync métodos várias vezes. Normalmente, isto não representa exceção. No entanto, dependendo de como um tipo implementa IDisposable.Dispose ou IAsyncDisposable.DisposeAsync, pode não permitir múltiplas chamadas para esse método.

Na maioria dos casos, esta exceção resulta de erro do programador. Em vez de tratar o erro num try/catch bloco, deve corrigi-lo, normalmente reinstaurando o objeto.

Ver também

• IDisposable