GC.AddMemoryPressure(Int64) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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);
[System.Security.SecurityCritical]
public static void AddMemoryPressure (long bytesAllocated);
public static void AddMemoryPressure (long bytesAllocated);
[<System.Security.SecurityCritical>]
static member AddMemoryPressure : int64 -> unit
static member AddMemoryPressure : int64 -> unit
Public Shared Sub AddMemoryPressure (bytesAllocated As Long)

Parametri

bytesAllocated
Int64

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

Attributi
SecurityCriticalAttribute

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.

Si applica a