ObjectDisposedException Třída

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

ObjectDisposedException.cs

Výjimka, která je vyvolán při provedení operace s odstraněným objektem.

public ref class ObjectDisposedException : InvalidOperationException

public class ObjectDisposedException : InvalidOperationException

type ObjectDisposedException = class
    inherit InvalidOperationException

Public Class ObjectDisposedException
Inherits InvalidOperationException

Dědičnost

Object

Exception

SystemException

InvalidOperationException

ObjectDisposedException

Příklady

Následující příklad ukazuje chybu, která způsobí ObjectDisposedException vyvolání výjimky.

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

Tento kód vytvoří následující výstup:

Caught:
  Cannot access a closed Stream.

Poznámky

Vyvolá ObjectDisposedException se při pokusu o přístup k členu objektu, který implementuje IDisposable rozhraní nebo IAsyncDisposable rozhraní, a tento objekt byl odstraněn. Tato výjimka je obvykle způsobena jednou z následujících podmínek:

• Volali jste metodu IDisposable objektu Dispose (nebo metodu IDisposableAsync objektu DisposeAsync ) a pokoušíte se získat přístup k členu instance, který získá nebo nastaví stav objektu. Následující příklad ukazuje ObjectDisposedException , že je vyvolán při pokusu o resetování frekvence oznámení časovače po volání Timer.Dispose metody.

  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()
  

• Volali jste metodu objektu Close a pokoušíte se získat přístup k členu instance, který získá nebo nastaví stav objektu. Close Metoda často poskytuje veřejnou implementaci IDisposable.Dispose metody typu. Totéž platí pro CloseAsync a <xref:System.IAsyncDisposable.DisposeAsync*?displayProperty=nameWithType>.

• Několikrát jste volali objekt Dispose nebo DisposeAsync metody. Obvykle se tím nevyvolá výjimka. Nicméně v závislosti na tom, jak typ implementuje IDisposable.Dispose nebo IAsyncDisposable.DisposeAsync, nemusí povolit více volání této metody.

Ve většině případů má tato výjimka za následek chybu vývojáře. Místo zpracování chyby v try/catch bloku byste měli chybu opravit, obvykle opětovným zadáním objektu.

Konstruktory

Name	Description
ObjectDisposedException(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci ObjectDisposedException třídy serializovanými daty.
ObjectDisposedException(String, Exception)	Inicializuje novou instanci ObjectDisposedException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.
ObjectDisposedException(String, String)	Inicializuje novou instanci ObjectDisposedException třídy se zadaným názvem objektu a zprávou.
ObjectDisposedException(String)	Inicializuje novou instanci ObjectDisposedException třídy s řetězcem obsahujícím název odstraněného objektu.

Vlastnosti

Name	Description
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje chybu.
ObjectName	Získá název odstraněného objektu.
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. SerializationInfo Načte objekt s názvem parametru a dalšími informacemi o výjimce.
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ThrowIf(Boolean, Object)	Vyvolá chybuObjectDisposedException, pokud je truezadaná condition hodnota .
ThrowIf(Boolean, Type)	Vyvolá chybuObjectDisposedException, pokud je truezadaná condition hodnota .
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

Name	Description
SerializeObjectState	Zastaralé. Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)

Viz také

• IDisposable