GC.SuppressFinalize Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Requests that the system not call the finalizer for the specified object.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
Public Shared Sub SuppressFinalize ( _
obj As Object _
)
public static void SuppressFinalize(
Object obj
)
Parameters
- obj
Type: System..::.Object
The object that a finalizer must not be called for.
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | obj is nullNothingnullptra null reference (Nothing in Visual Basic). |
Remarks
This method sets a bit in the object header, which the system checks when calling finalizers. The obj parameter is required to be the caller of this method.
Objects that implement the IDisposable interface can call this method from the IDisposable..::.Dispose method to prevent the garbage collector from calling Object..::.Finalize on an object that does not require it.
Version Information
Windows Phone OS
Supported in: 8.1, 8.0, 7.1, 7.0
Platforms
Windows Phone