Export (0) Print
Expand All
3 out of 4 rated this helpful - Rate this topic

GC.AddMemoryPressure Method

Note: This method is new in the .NET Framework version 2.0.

Informs the runtime of a large allocation of unmanaged memory that should be taken into account when scheduling garbage collection.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public static void AddMemoryPressure (
	long bytesAllocated
)
public static void AddMemoryPressure (
	long bytesAllocated
)
public static function AddMemoryPressure (
	bytesAllocated : long
)

Parameters

bytesAllocated

The incremental amount of unmanaged memory that has been allocated.

Exception typeCondition

ArgumentOutOfRangeException

bytesAllocated is less than or equal to 0.

-or-

On a 32-bit computer, bytesAllocated is larger than Int32.MaxValue.

In determining when to schedule garbage collection, the runtime takes into account how much managed memory is allocated. If a small managed object allocates a large amount of unmanaged memory, the runtime takes into account only the managed memory, and thus underestimates the urgency of scheduling garbage collection. The AddMemoryPressure method informs the runtime of this additional pressure on system memory.

In the simplest usage pattern, a managed object allocates unmanaged memory in the constructor and releases it in the Dispose or Finalize method. Call the AddMemoryPressure method after allocating the unmanaged memory, and call the RemoveMemoryPressure method after releasing it.

In more complicated scenarios, where the unmanaged memory allocation changes substantially during the lifetime of the managed object, you can call the AddMemoryPressure and RemoveMemoryPressure methods to communicate these incremental changes to the runtime.

Caution noteCaution

You must ensure that you remove exactly the amount of pressure you add. Failing to do so can adversely affect the performance of the system in applications that run for long periods of time.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.