RuntimeHelpers RuntimeHelpers RuntimeHelpers RuntimeHelpers Class

Определение

Предоставляет набор статических методов и свойств для поддержки компиляторов.Provides a set of static methods and properties that provide support for compilers. Этот класс не наследуется.This class cannot be inherited.

public ref class RuntimeHelpers abstract sealed
[System.Serializable]
public static class RuntimeHelpers
type RuntimeHelpers = class
Public Class RuntimeHelpers
Наследование
RuntimeHelpersRuntimeHelpersRuntimeHelpersRuntimeHelpers
Атрибуты

Примеры

В следующем примере показано, как надежно задать дескрипторы с помощью PrepareConstrainedRegions метода.The following example shows how to reliably set handles by using the PrepareConstrainedRegions method. Для надежной установки маркера на указанный ранее обработчик необходимо убедиться, что выделение собственного и последующей записи этого маркера в SafeHandle объекте является атомарным.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. Можно использовать PrepareConstrainedRegions метод, чтобы убедиться в том, что дескриптор не был утечкой.You can use the PrepareConstrainedRegions method to make sure that the handle is not leaked.

[StructLayout(LayoutKind.Sequential)]
struct MyStruct
{
    public IntPtr m_outputHandle;
}

sealed class MySafeHandle : SafeHandle
{
    // Called by P/Invoke when returning SafeHandles
    public MySafeHandle()
        : base(IntPtr.Zero, true)
    {
    }

    public MySafeHandle AllocateHandle()
    {
        // Allocate SafeHandle first to avoid failure later.
        MySafeHandle sh = new MySafeHandle();

        RuntimeHelpers.PrepareConstrainedRegions();
        try { }
        finally
        {
            MyStruct myStruct = new MyStruct();
            NativeAllocateHandle(ref myStruct);
            sh.SetHandle(myStruct.m_outputHandle);
        }

        return sh;
    }

<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


Свойства

OffsetToStringData OffsetToStringData OffsetToStringData OffsetToStringData

Получает смещение в байтах к данным в указанной строке.Gets the offset, in bytes, to the data in the given string.

Методы

EnsureSufficientExecutionStack() EnsureSufficientExecutionStack() EnsureSufficientExecutionStack() EnsureSufficientExecutionStack()

Обеспечивает достаточный запас пространства стека для выполнения средней функции платформы .NET Framework.Ensures that the remaining stack space is large enough to execute the average .NET Framework function.

Equals(Object, Object) Equals(Object, Object) Equals(Object, Object) Equals(Object, Object)

Определяет, считаются ли равными указанные экземпляры Object.Determines whether the specified Object instances are considered equal.

ExecuteCodeWithGuaranteedCleanup(RuntimeHelpers+TryCode, RuntimeHelpers+CleanupCode, Object) ExecuteCodeWithGuaranteedCleanup(RuntimeHelpers+TryCode, RuntimeHelpers+CleanupCode, Object) ExecuteCodeWithGuaranteedCleanup(RuntimeHelpers+TryCode, RuntimeHelpers+CleanupCode, Object) ExecuteCodeWithGuaranteedCleanup(RuntimeHelpers+TryCode, RuntimeHelpers+CleanupCode, Object)

Выполняет код с помощью делегата Delegate, используя другой делегат Delegate для выполнения дополнительного кода в случае исключения.Executes code using a Delegate while using another Delegate to execute additional code in case of an exception.

GetHashCode(Object) GetHashCode(Object) GetHashCode(Object) GetHashCode(Object)

Служит в качестве хэш-функции для конкретного объекта и подходит для использования в алгоритмах и структурах данных, использующих хэш-коды, например в хэш-таблице.Serves as a hash function for a particular object, and is suitable for use in algorithms and data structures that use hash codes, such as a hash table.

GetObjectValue(Object) GetObjectValue(Object) GetObjectValue(Object) GetObjectValue(Object)

Упаковывает тип значения.Boxes a value type.

GetSubArray<T>(T[], Range) GetSubArray<T>(T[], Range) GetSubArray<T>(T[], Range) GetSubArray<T>(T[], Range)

Создает срез указанного массива, используя указанный диапазон.Slices the specified array using the specified range.

GetUninitializedObject(Type) GetUninitializedObject(Type) GetUninitializedObject(Type) GetUninitializedObject(Type)
InitializeArray(Array, RuntimeFieldHandle) InitializeArray(Array, RuntimeFieldHandle) InitializeArray(Array, RuntimeFieldHandle) InitializeArray(Array, RuntimeFieldHandle)

Предоставляет быстрый способ инициализации массива данных, хранящихся в модуле.Provides a fast way to initialize an array from data that is stored in a module.

IsReferenceOrContainsReferences<T>() IsReferenceOrContainsReferences<T>() IsReferenceOrContainsReferences<T>() IsReferenceOrContainsReferences<T>()

Возвращает значение, указывающее, является ли указанный тип ссылочным типом или типом значения, содержащим ссылки.Returns a value that indicates whether the specified type is a reference type or a value type that contains references.

PrepareConstrainedRegions() PrepareConstrainedRegions() PrepareConstrainedRegions() PrepareConstrainedRegions()

Назначает основную часть кода как область с ограничением исполнения (CER).Designates a body of code as a constrained execution region (CER).

PrepareConstrainedRegionsNoOP() PrepareConstrainedRegionsNoOP() PrepareConstrainedRegionsNoOP() PrepareConstrainedRegionsNoOP()

Назначает основную часть кода областью с ограничением исполнения (CER) без какой-либо проверки.Designates a body of code as a constrained execution region (CER) without performing any probing.

PrepareContractedDelegate(Delegate) PrepareContractedDelegate(Delegate) PrepareContractedDelegate(Delegate) PrepareContractedDelegate(Delegate)

Предоставляет приложению способ динамической подготовки делегатов событий AppDomain.Provides a way for applications to dynamically prepare AppDomain event delegates.

PrepareDelegate(Delegate) PrepareDelegate(Delegate) PrepareDelegate(Delegate) PrepareDelegate(Delegate)

Указывает, что заданный делегат следует подготовить к включению в область с ограничением исполнения (CER).Indicates that the specified delegate should be prepared for inclusion in a constrained execution region (CER).

PrepareMethod(RuntimeMethodHandle) PrepareMethod(RuntimeMethodHandle) PrepareMethod(RuntimeMethodHandle) PrepareMethod(RuntimeMethodHandle)

Подготавливает метод к включению в область с ограничением исполнения (CER).Prepares a method for inclusion in a constrained execution region (CER).

PrepareMethod(RuntimeMethodHandle, RuntimeTypeHandle[]) PrepareMethod(RuntimeMethodHandle, RuntimeTypeHandle[]) PrepareMethod(RuntimeMethodHandle, RuntimeTypeHandle[]) PrepareMethod(RuntimeMethodHandle, RuntimeTypeHandle[])

Подготавливает метод для включения в область с ограничением исполнения (CER) с указанной реализацией.Prepares a method for inclusion in a constrained execution region (CER) with the specified instantiation.

ProbeForSufficientStack() ProbeForSufficientStack() ProbeForSufficientStack() 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). Рекомендуется вместо этого метода использовать область с ограничением исполнения (CER).We recommend that you use a constrained execution region (CER) instead of this method.

RunClassConstructor(RuntimeTypeHandle) RunClassConstructor(RuntimeTypeHandle) RunClassConstructor(RuntimeTypeHandle) RunClassConstructor(RuntimeTypeHandle)

Обеспечивает выполнение инициализатора типа (также называемого статическим конструктором) для указанного типа.Ensures that the type initializer (also known as a static constructor) for the specified type has been run.

RunModuleConstructor(ModuleHandle) RunModuleConstructor(ModuleHandle) RunModuleConstructor(ModuleHandle) RunModuleConstructor(ModuleHandle)

Выполняет указанный метод конструктора модуля.Runs a specified module constructor method.

TryEnsureSufficientExecutionStack() TryEnsureSufficientExecutionStack() TryEnsureSufficientExecutionStack() TryEnsureSufficientExecutionStack()

Применяется к