GC.AddMemoryPressure(Int64) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Origine:

GC.CoreCLR.cs

Informa il runtime di un'allocazione di una grande quantità di memoria non gestita di cui tenere conto durante la pianificazione della procedura di Garbage Collection.

public:
 static void AddMemoryPressure(long bytesAllocated);

public static void AddMemoryPressure (long bytesAllocated);

static member AddMemoryPressure : int64 -> unit

Public Shared Sub AddMemoryPressure (bytesAllocated As Long)

Parametri

bytesAllocated

Int64

Quantità incrementale di memoria non gestita che è stata allocata.

Eccezioni

ArgumentOutOfRangeException

bytesAllocated è minore o uguale a 0.

-oppure-

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

Commenti

Per determinare quando pianificare 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 tiene conto solo della memoria gestita e quindi sottovaluta l'urgenza della pianificazione di Garbage Collection. Il AddMemoryPressure metodo informa il runtime di questa pressione aggiuntiva sulla memoria di sistema.

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 di eliminazione, dove gli 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 dell'oggetto e sul modello di eliminazione, vedere Pulizia delle risorse non gestite.

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

Negli scenari più complessi, in cui l'allocazione della memoria non gestita cambia notevolmente 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 aggiunta. La mancata operazione può influire negativamente sulle prestazioni del sistema nelle applicazioni che vengono eseguite per lunghi periodi di tempo.