GC.RemoveMemoryPressure(Int64) メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

ソース:

GC.CoreCLR.cs

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

public:
 static void RemoveMemoryPressure(long bytesAllocated);

public static void RemoveMemoryPressure (long bytesAllocated);

static member RemoveMemoryPressure : int64 -> unit

Public Shared Sub RemoveMemoryPressure (bytesAllocated As Long)

パラメーター

bytesAllocated

Int64

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

例外

ArgumentOutOfRangeException

bytesAllocated が 0 以下です。

または

32 ビット コンピューターでは、 bytesAllocated が Int32.MaxValue を超えています。

注釈

ガベージ コレクションをスケジュールするタイミングを決定する際に、ランタイムでは、割り当てられるマネージド メモリの量が考慮されます。 小さなマネージド オブジェクトが大量のアンマネージド メモリを割り当てる場合、ランタイムはマネージド メモリのみを考慮するため、ガベージ コレクションのスケジュールの緊急度を過小評価します。 メソッドは AddMemoryPressure 、システム メモリに対するこの追加の負荷をランタイムに通知し RemoveMemoryPressure 、追加の負荷が解放されたことをランタイムに通知します。

メソッドと RemoveMemoryPressure メソッドはAddMemoryPressure、アンマネージド リソースを解放するためにファイナライザーのみに依存する型に対してのみパフォーマンスを向上させます。 破棄パターンに従う型でこれらのメソッドを使用する必要はありません。ファイナライザーを使用してアンマネージ リソースをクリーンするのは、型のコンシューマーが を呼び出Disposeすのを忘れた場合のみです。 オブジェクトの最終処理と破棄パターンの詳細については、「 アンマネージ リソースのクリーンアップ」を参照してください。

最も単純な使用パターンでは、マネージド オブジェクトによってコンストラクターにアンマネージ メモリが割り当てられ、 メソッドで解放されます Finalize 。 アンマネージド メモリを AddMemoryPressure 割り当てた後に メソッドを呼び出し、解放後に RemoveMemoryPressure メソッドを呼び出します。

マネージド オブジェクトの有効期間中にアンマネージド メモリの割り当てが大幅に変更される、より複雑なシナリオでは、 メソッドと RemoveMemoryPressure メソッドをAddMemoryPressure呼び出して、これらの増分変更をランタイムに伝達できます。

注意事項

追加する圧力の量を正確に削除する必要があります。 これを行わないと、長時間実行されるアプリケーションのシステムのパフォーマンスに悪影響を及ぼす可能性があります。