GC.RemoveMemoryPressure メソッド

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

GC.RemoveMemoryPressure メソッド

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

アンマネージ メモリが解放され、ガベージ コレクションのスケジュールにこのメモリを考慮する必要がなくなったことをランタイムに通知します。

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

Visual Basic (宣言)

Public Shared Sub RemoveMemoryPressure
 ( _
    bytesAllocated As Long _
)

Visual Basic (使用法)

Dim bytesAllocated As Long

GC.RemoveMemoryPressure(bytesAllocated)

C#

public static void RemoveMemoryPressure
 (
    long bytesAllocated
)

C++

public:
static void RemoveMemoryPressure (
    long long bytesAllocated
)

J#

public static void RemoveMemoryPressure
 (
    long bytesAllocated
)

JScript

public static function RemoveMemoryPressure
 (
    bytesAllocated : long
)

パラメータ

bytesAllocated

解放されたアンマネージ メモリの量

例外

例外の種類	条件
ArgumentOutOfRangeException	bytesAllocated が 0 以下です。 または 32 ビットのコンピュータで、bytesAllocated の値が Int32.MaxValue の値を超えています。

解説

ガベージ コレクションの実行スケジュールを決定する場合、ランタイムでは、マネージ メモリの割当量が考慮されます。小さいマネージ オブジェクトによって大量のアンマネージ メモリが割り当てられた場合、ランタイムでは、マネージ メモリだけが考慮されるので、ガベージ コレクションを緊急にスケジュールする必要があっても、その必要性が過小評価されます。このようなシステム メモリに対する圧迫の追加が、AddMemoryPressure メソッドによってランタイムに通知されます。また、追加された圧迫が解放されたことが RemoveMemoryPressure メソッドによってランタイムに通知されます。

最も簡単な例は、マネージ オブジェクトによってコンストラクタ内にアンマネージ メモリが割り当てられ、Dispose メソッドまたは Finalize メソッドで解放されるような場合です。アンマネージ メモリを割り当てた後で AddMemoryPressure メソッドを呼び出し、そのメモリの解放後に RemoveMemoryPressure メソッドを呼び出します。

より複雑な例は、マネージ オブジェクトの有効期間中にアンマネージ メモリ割り当てが大きく変更されるような場合です。この場合、AddMemoryPressure メソッドおよび RemoveMemoryPressure メソッドを呼び出して、これらの追加変更をランタイムに通知します。

注意
追加する圧迫の量とまったく同じ量だけを削除するように注意してください。この操作に失敗すると、長期間実行するアプリケーションでシステム パフォーマンスに悪影響があります。

.NET Framework のセキュリティ

• SecurityPermission  (ガベージ コレクションの優先順位を操作する場合にアンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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

参照

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