GC.RemoveMemoryPressure(Int64) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

GC.CoreCLR.cs

Menginformasikan runtime bahwa memori yang tidak dikelola telah dirilis dan tidak perlu lagi dipertanyakan saat menjadwalkan pengumpulan sampah.

public:
 static void RemoveMemoryPressure(long bytesAllocated);

public static void RemoveMemoryPressure (long bytesAllocated);

static member RemoveMemoryPressure : int64 -> unit

Public Shared Sub RemoveMemoryPressure (bytesAllocated As Long)

Parameter

bytesAllocated

Int64

Jumlah memori tidak terkelola yang telah dirilis.

Pengecualian

ArgumentOutOfRangeException

bytesAllocated kurang dari atau sama dengan 0.

-atau-

Pada komputer 32-bit, bytesAllocated lebih besar dari Int32.MaxValue.

Keterangan

Dalam menentukan kapan harus menjadwalkan pengumpulan sampah, runtime memperhitungkan berapa banyak memori terkelola yang dialokasikan. Jika objek terkelola kecil mengalokasikan sejumlah besar memori yang tidak dikelola, runtime hanya memperhitungkan memori terkelola, dan dengan demikian meremehkan urgensi penjadwalan pengumpulan sampah. Metode ini AddMemoryPressure menginformasikan runtime tekanan tambahan ini pada memori sistem, dan RemoveMemoryPressure metode menginformasikan runtime bahwa tekanan tambahan telah dirilis.

Metode AddMemoryPressure dan RemoveMemoryPressure meningkatkan performa hanya untuk jenis yang secara eksklusif bergantung pada finalizer untuk merilis sumber daya yang tidak dikelola. Tidak perlu menggunakan metode ini dalam jenis yang mengikuti pola pembuangan, di mana finalizer digunakan untuk membersihkan sumber daya yang tidak dikelola hanya jika konsumen jenis lupa memanggil Dispose. Untuk informasi selengkapnya tentang finalisasi objek dan pola pembuangan, lihat Membersihkan Sumber Daya yang Tidak Dikelola.

Dalam pola penggunaan yang paling sederhana, objek terkelola mengalokasikan memori yang tidak dikelola di konstruktor dan merilisnya dalam Finalize metode . AddMemoryPressure Panggil metode setelah mengalokasikan memori yang tidak dikelola, dan panggil RemoveMemoryPressure metode setelah merilisnya.

Dalam skenario yang lebih rumit, di mana alokasi memori yang tidak dikelola berubah secara substansial selama masa pakai objek terkelola, Anda dapat memanggil AddMemoryPressure metode dan RemoveMemoryPressure untuk mengomunikasikan perubahan inkremental ini ke runtime.

Perhatian

Anda harus memastikan bahwa Anda menghapus jumlah tekanan yang Anda tambahkan dengan tepat. Gagal melakukannya dapat berdampak buruk pada performa sistem dalam aplikasi yang berjalan untuk jangka waktu yang lama.