RuntimeHelpers Classe

Definizione

Fornisce un insieme di proprietà e metodi statici che forniscono supporto per i compilatori.Provides a set of static methods and properties that provide support for compilers. La classe non può essere ereditata.This class cannot be inherited.

public ref class RuntimeHelpers abstract sealed
[System.Serializable]
public static class RuntimeHelpers
type RuntimeHelpers = class
Public Class RuntimeHelpers
Ereditarietà
RuntimeHelpers
Attributi

Esempi

Nell'esempio seguente viene illustrato come impostare in modo affidabile gli handle utilizzando il metodo PrepareConstrainedRegions.The following example shows how to reliably set handles by using the PrepareConstrainedRegions method. Per impostare in modo affidabile un handle per un handle preesistente specificato, è necessario assicurarsi che l'allocazione dell'handle nativo e la registrazione successiva di tale handle in un oggetto SafeHandle siano atomiche.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. Qualsiasi errore tra queste operazioni, ad esempio un'interruzione del thread o un'eccezione di memoria insufficiente, comporterà la perdita dell'handle nativo.Any failure between these operations (such as a thread abort or out-of-memory exception) will result in the native handle being leaked. È possibile usare il metodo PrepareConstrainedRegions per assicurarsi che l'handle non venga perso.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


Proprietà

OffsetToStringData

Ottiene l'offset, in byte, per i dati nella stringa specificata.Gets the offset, in bytes, to the data in the given string.

Metodi

EnsureSufficientExecutionStack()

Assicura che lo spazio dello stack restante sia sufficiente per eseguire la funzione di .NET Framework media.Ensures that the remaining stack space is large enough to execute the average .NET Framework function.

Equals(Object, Object)

Determina se le istanze di Object specificate sono considerate uguali.Determines whether the specified Object instances are considered equal.

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

Esegue il codice utilizzando Delegate, mentre si utilizza un altro oggetto Delegate per eseguire ulteriore codice in caso di eccezione.Executes code using a Delegate while using another Delegate to execute additional code in case of an exception.

GetHashCode(Object)

Viene utilizzato come funzione hash per un oggetto particolare ed è adatto per l'utilizzo in algoritmi e in strutture di dati che utilizzano i codici hash, quali una tabella hash.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)

Esegue la conversione boxing di un tipo di valore.Boxes a value type.

GetSubArray<T>(T[], Range)

Seziona la matrice specificata usando l'intervallo specificato.Slices the specified array using the specified range.

GetUninitializedObject(Type)

Restituisce un'istanza non inizializzata del tipo fornito dal sistema.Returns an uninitialized instance of the system-provided type.

InitializeArray(Array, RuntimeFieldHandle)

Fornisce un modo rapido per inizializzare una matrice dai dati memorizzati in un modulo.Provides a fast way to initialize an array from data that is stored in a module.

IsReferenceOrContainsReferences<T>()

Restituisce un valore che indica se il tipo specificato è un tipo riferimento o un tipo valore contenente riferimenti.Returns a value that indicates whether the specified type is a reference type or a value type that contains references.

PrepareConstrainedRegions()

Indica un corpo di codice come area a esecuzione limitata (CER).Designates a body of code as a constrained execution region (CER).

PrepareConstrainedRegionsNoOP()

Indica un corpo di codice come area a esecuzione limitata (CER) senza eseguire alcun probe.Designates a body of code as a constrained execution region (CER) without performing any probing.

PrepareContractedDelegate(Delegate)

Consente alle applicazioni di preparare in modo dinamico i delegati dell'evento AppDomain.Provides a way for applications to dynamically prepare AppDomain event delegates.

PrepareDelegate(Delegate)

Indica che è necessario preparare il delegato specificato da includere in un'area a esecuzione vincolata (CER).Indicates that the specified delegate should be prepared for inclusion in a constrained execution region (CER).

PrepareMethod(RuntimeMethodHandle)

Prepara un metodo da includere in un'area a esecuzione limitata (CER).Prepares a method for inclusion in a constrained execution region (CER).

PrepareMethod(RuntimeMethodHandle, RuntimeTypeHandle[])

Prepara un metodo da includere in un'area a esecuzione limitata (CER) con la creazione dell'istanza specificata.Prepares a method for inclusion in a constrained execution region (CER) with the specified instantiation.

ProbeForSufficientStack()

Sonda una determinata quantità di spazio dello stack per garantire che non possa verificarsi un overflow dello stack all'interno di un blocco successivo di codice, presupponendo che il codice utilizzi una quantità limitata e moderata di spazio dello stack.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). Si consiglia di utilizzare un'area a esecuzione vincolata (CER) anziché questo metodo.We recommend that you use a constrained execution region (CER) instead of this method.

RunClassConstructor(RuntimeTypeHandle)

Assicura che sia stato eseguito l'inizializzatore di tipo (chiamato anche costruttore statico) per il tipo specificato.Ensures that the type initializer (also known as a static constructor) for the specified type has been run.

RunModuleConstructor(ModuleHandle)

Esegue il metodo del costruttore di moduli specificato.Runs a specified module constructor method.

TryEnsureSufficientExecutionStack()

Prova ad assicurare che sia presente uno stack sufficiente a eseguire la funzione di libreria .NET Core media.Tries to ensure there is sufficient stack to execute the average .NET Core library function.

Si applica a