RuntimeHelpers-Klasse

Stellt eine Reihe von statischen Methoden und Eigenschaften für die Unterstützung von Compilern zur Verfügung. Diese Klasse kann nicht geerbt werden.

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

Syntax

'Declaration
Public NotInheritable Class RuntimeHelpers
'Usage
Auf die Member einer statischen Klassen wird direkt ohne Instanz der Klasse zugegriffen.

public static class RuntimeHelpers

public ref class RuntimeHelpers abstract sealed

public final class RuntimeHelpers

public final class RuntimeHelpers

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Handles mit der PrepareConstrainedRegions-Methode zuverlässig festgelegt werden. Um ein Handle zuverlässig für ein angegebenes, bereits vorhandenes Handle festzulegen, müssen Sie sicherstellen, dass die Zuordnung des systemeigenen Handles und die nachfolgende Aufzeichnung dieses Handles in einem SafeHandle-Objekt atomar ist. Jeder Fehler zwischen diesen Operationen (z. B. eine Ausnahme wegen eines Threadabbruchs oder wegen mangelnden Arbeitsspeichers) führt zum Verlust des systemeigenen Handles. Sie können die PrepareConstrainedRegions-Methode verwenden, um sicherzustellen, dass kein Verlust des Handles erfolgt.

<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

[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;
    }

Vererbungshierarchie

System.Object
  System.Runtime.CompilerServices.RuntimeHelpers

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

RuntimeHelpers-Member
System.Runtime.CompilerServices-Namespace