ObjectDisposedException

.NET Framework クラス ライブラリ リファレンス

ObjectDisposedException クラス

破棄されたオブジェクトで操作が実行されるとスローされる例外。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As ObjectDisposedException

C#

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

C++

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

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class ObjectDisposedException extends
 InvalidOperationException

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class ObjectDisposedException extends
 InvalidOperationException

使用例

ObjectDisposedException 例外がスローされる原因となるエラーの例を次に示します。

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

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

このコードによって、次の出力が生成されます。

Caught:
  Cannot access a closed Stream.

継承階層

System.Object
   System.Exception
     System.SystemException
       System.InvalidOperationException
        System.ObjectDisposedException

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ObjectDisposedException メンバ
System 名前空間
IDisposable インターフェイス

ObjectDisposedException コンストラクタ (SerializationInfo, StreamingContext)

シリアル化したデータを使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    info As SerializationInfo, _
    context As StreamingContext _
)

Visual Basic (使用法)

Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New ObjectDisposedException(info,
 context)

C#

protected ObjectDisposedException (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
ObjectDisposedException (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected ObjectDisposedException (
    SerializationInfo info, 
    StreamingContext context
)

JScript

protected function ObjectDisposedException
 (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

スローされている例外に関するシリアル化済みオブジェクト データを保持している SerializationInfo。

context

転送元または転送先に関するコンテキスト情報を含んでいる StreamingContext。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ObjectDisposedException クラス
ObjectDisposedException メンバ
System 名前空間

ObjectDisposedException コンストラクタ (String, Exception)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    message As String, _
    innerException As Exception _
)

Visual Basic (使用法)

Dim message As String
Dim innerException As Exception

Dim instance As New ObjectDisposedException(message,
 innerException)

C#

public ObjectDisposedException (
    string message,
    Exception innerException
)

C++

public:
ObjectDisposedException (
    String^ message, 
    Exception^ innerException
)

J#

public ObjectDisposedException (
    String message, 
    Exception innerException
)

JScript

public function ObjectDisposedException (
    message : String, 
    innerException : Exception
)

パラメータ

message

例外の原因を説明するエラー メッセージ。

innerException

現在の例外の原因である例外。innerException が null 参照 (Visual Basic では Nothing) でない場合は、内部例外を処理する catch ブロックで現在の例外が発生します。

解説

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照が格納されます。InnerException プロパティは、コンストラクタに渡される値と同じ値を返します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ObjectDisposedException クラス
ObjectDisposedException メンバ
System 名前空間

ObjectDisposedException コンストラクタ

ObjectDisposedException クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
ObjectDisposedException (String)	破棄されたオブジェクトの名前が含まれている文字列を使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
ObjectDisposedException (SerializationInfo, StreamingContext)	シリアル化したデータを使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。
ObjectDisposedException (String, Exception)	指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。
ObjectDisposedException (String, String)	指定したオブジェクト名とメッセージを使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

ObjectDisposedException クラス
ObjectDisposedException メンバ
System 名前空間

ObjectDisposedException コンストラクタ (String, String)

指定したオブジェクト名とメッセージを使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    objectName As String, _
    message As String _
)

Visual Basic (使用法)

Dim objectName As String
Dim message As String

Dim instance As New ObjectDisposedException(objectName,
 message)

C#

public ObjectDisposedException (
    string objectName,
    string message
)

C++

public:
ObjectDisposedException (
    String^ objectName, 
    String^ message
)

J#

public ObjectDisposedException (
    String objectName, 
    String message
)

JScript

public function ObjectDisposedException (
    objectName : String, 
    message : String
)

パラメータ

objectName

破棄されたオブジェクトの名前。

message

例外の原因を説明するエラー メッセージ。

解説

新しいインスタンスの InnerException プロパティは、null 参照 (Visual Basic では Nothing) に初期化されます。

objectName が null 参照 (Visual Basic では Nothing) である場合、Message プロパティにはエラー メッセージだけが含まれます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ObjectDisposedException クラス
ObjectDisposedException メンバ
System 名前空間

ObjectDisposedException コンストラクタ (String)

破棄されたオブジェクトの名前が含まれている文字列を使用して、ObjectDisposedException クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    objectName As String _
)

Visual Basic (使用法)

Dim objectName As String

Dim instance As New ObjectDisposedException(objectName)

C#

public ObjectDisposedException (
    string objectName
)

C++

public:
ObjectDisposedException (
    String^ objectName
)

J#

public ObjectDisposedException (
    String objectName
)

JScript

public function ObjectDisposedException (
    objectName : String
)

パラメータ

objectName

破棄されたオブジェクトの名前が含まれている文字列。

解説

Message プロパティは、エラーの原因について記述し、objectName パラメータを含んでいる、システム提供のメッセージに初期化されます。このメッセージは、システムの現在のカルチャを考慮して指定します。

新しいインスタンスの InnerException プロパティは、null 参照 (Visual Basic では Nothing) に初期化されます。

objectName が null 参照 (Visual Basic では Nothing) である場合、Message プロパティにはエラー メッセージだけが含まれます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ObjectDisposedException クラス
ObjectDisposedException メンバ
System 名前空間

ObjectDisposedException プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 ( Exception から継承されます。)
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 ( Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。 ( Exception から継承されます。)
	Message	オーバーライドされます。 エラーを説明するメッセージを取得します。
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 ( Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。 ( Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。 ( Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 ( Exception から継承されます。)

参照

関連項目

ObjectDisposedException クラス
System 名前空間
IDisposable インターフェイス

ObjectDisposedException メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	オーバーライドされます。 パラメータ名と追加の例外情報を使用して SerializationInfo オブジェクトを取得します。
	GetType	現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 ( Exception から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

ObjectDisposedException クラス
System 名前空間
IDisposable インターフェイス

ObjectDisposedException メンバ

破棄されたオブジェクトで操作が実行されるとスローされる例外。

ObjectDisposedException データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

( プロテクト コンストラクタ も参照)

	名前	説明
	ObjectDisposedException	オーバーロードされます。 ObjectDisposedException クラスの新しいインスタンスを初期化します。

プロテクト コンストラクタ

	名前	説明
	ObjectDisposedException	オーバーロードされます。 ObjectDisposedException クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。(Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
	Message	オーバーライドされます。 エラーを説明するメッセージを取得します。
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。(Exception から継承されます。)

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。(Exception から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	オーバーライドされます。 パラメータ名と追加の例外情報を使用して SerializationInfo オブジェクトを取得します。
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

ObjectDisposedException クラス
System 名前空間
IDisposable インターフェイス