GC.RemoveMemoryPressure(Int64) Metodo

Definizione

Informa il runtime che è stata rilasciata memoria non gestita di cui non occorre più tenere conto durante la pianificazione della procedura di Garbage Collection.

[System.Security.SecurityCritical]
public static void RemoveMemoryPressure (long bytesAllocated);
public static void RemoveMemoryPressure (long bytesAllocated);

Parametri

bytesAllocated
Int64

Quantità di memoria non gestita che è stata rilasciata.

Attributi

Eccezioni

bytesAllocated è minore o uguale a 0.

-oppure-

In un computer a 32 bit è bytesAllocated maggiore di Int32.MaxValue.

Commenti

Per determinare quando pianificare l'operazione di Garbage Collection, il runtime tiene conto della quantità di memoria gestita allocata. Se un piccolo oggetto gestito alloca una grande quantità di memoria non gestita, il runtime prende in considerazione solo la memoria gestita e quindi sottovaluta l'urgenza di pianificare l'operazione di Garbage Collection. Il AddMemoryPressure metodo informa il runtime di questa pressione aggiuntiva sulla memoria di sistema e il RemoveMemoryPressure metodo informa il runtime che è stata rilasciata una pressione aggiuntiva.

I AddMemoryPressure metodi e RemoveMemoryPressure migliorano le prestazioni solo per i tipi che dipendono esclusivamente dai finalizzatori per rilasciare le risorse non gestite. Non è necessario usare questi metodi nei tipi che seguono il modello dispose, in cui i finalizzatori vengono usati per pulire le risorse non gestite solo nel caso in cui un consumer del tipo dimentica di chiamare Dispose. Per altre informazioni sulla finalizzazione degli oggetti e sul modello dispose, vedere Pulizia delle risorse non gestite.

Nel modello di utilizzo più semplice, un oggetto gestito alloca la memoria non gestita nel costruttore e la rilascia nel Finalize metodo . Chiamare il AddMemoryPressure metodo dopo aver allocato la memoria non gestita e chiamare il metodo dopo il RemoveMemoryPressure rilascio.

In scenari più complessi, in cui l'allocazione di memoria non gestita cambia sostanzialmente durante la durata dell'oggetto gestito, è possibile chiamare i AddMemoryPressure metodi e RemoveMemoryPressure per comunicare queste modifiche incrementali al runtime.

Attenzione

È necessario assicurarsi di rimuovere esattamente la quantità di pressione che si aggiunge. In caso contrario, è possibile influire negativamente sulle prestazioni del sistema nelle applicazioni eseguite per lunghi periodi di tempo.

Si applica a

Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0