InsufficientMemoryException

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

InsufficientMemoryException クラス

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

この例外は、使用可能なメモリが十分に残っているかどうかのチェックで、要件が満たされなかった場合にスローされます。このクラスは継承できません。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 InsufficientMemoryException
    Inherits OutOfMemoryException

Visual Basic (使用法)

Dim instance As InsufficientMemoryException

C#

[SerializableAttribute] 
public sealed class InsufficientMemoryException
 : OutOfMemoryException

C++

[SerializableAttribute] 
public ref class InsufficientMemoryException
 sealed : public OutOfMemoryException

J#

/** @attribute SerializableAttribute() */ 
public final class InsufficientMemoryException
 extends OutOfMemoryException

JScript

SerializableAttribute 
public final class InsufficientMemoryException
 extends OutOfMemoryException

解説

OutOfMemoryException とは異なり、InsufficientMemoryException は操作の開始前にスローされ、実際の障害を表すものではありません。アプリケーションでこの例外をキャッチして、メモリ使用量を減らすことによって、メモリ不足から発生する可能性のあるプログラムの障害を未然に防ぐことができます。

この例外は、メモリの割り当てが使用可能なメモリ量を超えた場合に、MemoryFailPoint コンストラクタによってスローされます。プログラムからこの例外をキャッチすることによって、大量のメモリを必要とするタスクを後回しにしたり、メモリ消費のより少ない方法でタスクを実行するなどして調整できます。

コード例については、MemoryFailPoint クラスのトピックを参照してください。

継承階層

System.Object
   System.Exception
     System.SystemException
       System.OutOfMemoryException
        System.InsufficientMemoryException

スレッド セーフ

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

プラットフォーム

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

参照

関連項目
InsufficientMemoryException メンバ
System 名前空間
MemoryFailPoint

InsufficientMemoryException コンストラクタ ()

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

エラーを説明するシステム提供のメッセージを使用して、InsufficientMemoryException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New InsufficientMemoryException

C#

public InsufficientMemoryException ()

C++

public:
InsufficientMemoryException ()

J#

public InsufficientMemoryException ()

JScript

public function InsufficientMemoryException
 ()

解説

このコンストラクタは、新しいインスタンスの Message プロパティを、"操作の要求を満足させる利用可能なメモリが現時点で不足しています。後からもう一度実行してください。" などのエラーを説明するシステムから提供されるメッセージに初期化します。このメッセージは、システムの現在のカルチャを考慮して指定します。

InsufficientMemoryException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	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

参照

関連項目
InsufficientMemoryException クラス
InsufficientMemoryException メンバ
System 名前空間
その他の技術情報
例外の処理とスロー

InsufficientMemoryException コンストラクタ (String)

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

エラーを説明する指定したメッセージを使用して、InsufficientMemoryException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New InsufficientMemoryException(message)

C#

public InsufficientMemoryException (
    string message
)

C++

public:
InsufficientMemoryException (
    String^ message
)

J#

public InsufficientMemoryException (
    String message
)

JScript

public function InsufficientMemoryException
 (
    message : String
)

パラメータ

message

例外を説明するメッセージ。このコンストラクタの呼び出し元は、この文字列が現在のシステムのカルチャに合わせてローカライズ済みであることを確認しておく必要があります。

解説

InsufficientMemoryException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	null 参照 (Visual Basic では Nothing).
Message	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

参照

関連項目
InsufficientMemoryException クラス
InsufficientMemoryException メンバ
System 名前空間
その他の技術情報
例外の処理とスロー

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

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

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

名前空間: 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 InsufficientMemoryException(message,
 innerException)

C#

public InsufficientMemoryException (
    string message,
    Exception innerException
)

C++

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

J#

public InsufficientMemoryException (
    String message, 
    Exception innerException
)

JScript

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

パラメータ

message

例外を説明するメッセージ。このコンストラクタの呼び出し元は、この文字列が現在のシステムのカルチャに合わせてローカライズ済みであることを確認しておく必要があります。

innerException

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

解説

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照が格納されます。InnerException プロパティは、コンストラクタに渡されたものと同じ値を返します。InnerException プロパティによって内部例外値がコンストラクタに渡されなかった場合は、null 参照 (Visual Basic では Nothing) を返します。

InsufficientMemoryException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	null 参照 (Visual Basic では Nothing).
Message	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

参照

関連項目
InsufficientMemoryException クラス
InsufficientMemoryException メンバ
System 名前空間
その他の技術情報
例外の処理とスロー

InsufficientMemoryException コンストラクタ

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

名前	説明
InsufficientMemoryException ()	エラーを説明するシステム提供のメッセージを使用して、InsufficientMemoryException クラスの新しいインスタンスを初期化します。
InsufficientMemoryException (String)	エラーを説明する指定したメッセージを使用して、InsufficientMemoryException クラスの新しいインスタンスを初期化します。
InsufficientMemoryException (String, Exception)	指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、InsufficientMemoryException クラスの新しいインスタンスを初期化します。

参照

関連項目

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

その他の技術情報

例外の処理とスロー

InsufficientMemoryException プロパティ

パブリック プロパティ

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

参照

関連項目

InsufficientMemoryException クラス
System 名前空間
MemoryFailPoint

InsufficientMemoryException メソッド

パブリック メソッド

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

参照

関連項目

InsufficientMemoryException クラス
System 名前空間
MemoryFailPoint

InsufficientMemoryException メンバ

この例外は、使用可能なメモリが十分に残っているかどうかのチェックで、要件が満たされなかった場合にスローされます。このクラスは継承できません。

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

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

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

パブリック プロパティ

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

パブリック メソッド

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

参照

関連項目

InsufficientMemoryException クラス
System 名前空間
MemoryFailPoint