RuntimeHelpers Class
Provides a set of static methods and properties that provide support for compilers. This class cannot be inherited.
Assembly: mscorlib (in mscorlib.dll)
The RuntimeHelpers type exposes the following members.
| Name | Description | |
|---|---|---|
![]() ![]() | EnsureSufficientExecutionStack | Ensures that the remaining stack space is large enough to execute the average .NET Framework function. |
![]() ![]() | Equals(Object, Object) | Determines whether the specified Object instances are considered equal. |
![]() ![]() | ExecuteCodeWithGuaranteedCleanup | Executes code using a Delegate while using another Delegate to execute additional code in case of an exception. |
![]() ![]() | GetHashCode(Object) | Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures such as a hash table. |
![]() ![]() ![]() ![]() | GetObjectValue | Boxes a value type. |
![]() ![]() ![]() ![]() | InitializeArray | Provides a fast way to initialize an array from data that is stored in a module. |
![]() ![]() | PrepareConstrainedRegions | Designates a body of code as a constrained execution region (CER). |
![]() ![]() | PrepareConstrainedRegionsNoOP | Designates a body of code as a constrained execution region (CER) without performing any probing. |
![]() ![]() | PrepareContractedDelegate | Provides a way for applications to dynamically prepare AppDomain event delegates. |
![]() ![]() | PrepareDelegate | Indicates that the specified delegate should be prepared for inclusion in a constrained execution region (CER). |
![]() ![]() | PrepareMethod(RuntimeMethodHandle) | Prepares a method for inclusion in a constrained execution region (CER). |
![]() ![]() | PrepareMethod(RuntimeMethodHandle, RuntimeTypeHandle()) | Prepares a method for inclusion in a constrained execution region (CER) with the specified instantiation. |
![]() ![]() | ProbeForSufficientStack | Probes for a certain amount of stack space to ensure that a stack overflow cannot happen within a subsequent block of code (assuming that your code uses only a finite and moderate amount of stack space). We recommend that you use a constrained execution region (CER) instead of this method. |
![]() ![]() | RunClassConstructor | Runs a specified class constructor method. |
![]() ![]() | RunModuleConstructor | Runs a specified module constructor method. |
The following example shows how to reliably set handles by using the PrepareConstrainedRegions method. To reliably set a handle to a specified pre-existing handle, you must ensure that the allocation of the native handle and the subsequent recording of that handle within a SafeHandle object is atomic. Any failure between these operations (such as a thread abort or out-of-memory exception) will result in the native handle being leaked. You can use the PrepareConstrainedRegions method to make sure that the handle is not leaked.
<StructLayout(LayoutKind.Sequential)> _ Structure MyStruct Public m_outputHandle As IntPtr End Structure 'MyStruct NotInheritable Class MySafeHandle Inherits SafeHandle ' Called by P/Invoke when returning SafeHandles Public Sub New() MyBase.New(IntPtr.Zero, True) End Sub Public Function AllocateHandle() As MySafeHandle ' Allocate SafeHandle first to avoid failure later. Dim sh As New MySafeHandle() RuntimeHelpers.PrepareConstrainedRegions() Try Finally Dim myStruct As New MyStruct() NativeAllocateHandle(myStruct) sh.SetHandle(myStruct.m_outputHandle) End Try Return sh End Function
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

