Marshal.ReadIntPtr Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Čte celé číslo nativní velikosti procesoru z nespravované paměti. Čtení z nerovnaných umístění paměti se podporuje.

Přetížení

Name	Description
ReadIntPtr(IntPtr, Int32)	Načte celé číslo nativní velikosti procesoru na daném posunu od nespravované paměti.
ReadIntPtr(Object, Int32)	Zastaralé. Čte celé číslo nativní velikosti procesoru z nespravované paměti.
ReadIntPtr(IntPtr)	Čte celé číslo nativní velikosti procesoru z nespravované paměti.

ReadIntPtr(IntPtr, Int32)

Zdroj:

Marshal.cs

Načte celé číslo nativní velikosti procesoru na daném posunu od nespravované paměti.

public:
 static IntPtr ReadIntPtr(IntPtr ptr, int ofs);

public static IntPtr ReadIntPtr(IntPtr ptr, int ofs);

static member ReadIntPtr : nativeint * int -> nativeint

Public Shared Function ReadIntPtr (ptr As IntPtr, ofs As Integer) As IntPtr

Parametry

ptr

IntPtr

nativeint

Základní adresa v nespravované paměti, ze které se má číst.

ofs

Int32

Další posun bajtu, který se před čtením přidá do parametru ptr .

Návraty

IntPtr

nativeint

Celé číslo přečtené z nespravované paměti na daném posunu.

Výjimky

AccessViolationException

Základní adresa (ptr) plus posun bajtů (ofs) vytvoří hodnotu null nebo neplatnou adresu.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadIntPtr a WriteIntPtr metod.

static void ReadWriteIntPtr()
{
    // Allocate unmanaged memory. 
    int elementSize = Marshal.SizeOf(typeof(IntPtr));
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, ((IntPtr)(i + 1)));
    }
    Console.WriteLine("Unmanaged memory written.");

    Console.WriteLine("Reading unmanaged memory:");
    // Print the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Poznámky

ReadIntPtr umožňuje přímou interakci s nespravovaným polem ve stylu IntPtr jazyka C a eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot prvků.

Čtení z nerovnaných umístění paměti se podporuje.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)
• ReadByte(Object, Int32)

ReadIntPtr(Object, Int32)

Zdroj:

Marshal.cs

Upozornění

ReadIntPtr(Object, Int32) may be unavailable in future releases.

Čte celé číslo nativní velikosti procesoru z nespravované paměti.

public:
 static IntPtr ReadIntPtr(System::Object ^ ptr, int ofs);

[System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")]
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")]
public static IntPtr ReadIntPtr(object ptr, int ofs);

[<System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")>]
static member ReadIntPtr : obj * int -> nativeint

Public Shared Function ReadIntPtr (ptr As Object, ofs As Integer) As IntPtr

Parametry

ptr

Object

Základní adresa v nespravované paměti zdrojového objektu.

ofs

Int32

Další posun bajtu, který se před čtením přidá do parametru ptr .

Návraty

IntPtr

nativeint

Celé číslo přečtené z nespravované paměti na daném posunu.

Atributy

ObsoleteAttribute RequiresDynamicCodeAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) plus posun bajtů (ofs) vytvoří hodnotu null nebo neplatnou adresu.

ArgumentException

ptr ArrayWithOffset je objekt. Tato metoda nepřijímá ArrayWithOffset parametry.

Poznámky

ReadIntPtr umožňuje přímou interakci s nespravovaným polem ve stylu IntPtr jazyka C a eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot prvků.

Čtení z nerovnaných umístění paměti se podporuje.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)

ReadIntPtr(IntPtr)

Zdroj:

Marshal.cs

Čte celé číslo nativní velikosti procesoru z nespravované paměti.

public:
 static IntPtr ReadIntPtr(IntPtr ptr);

public static IntPtr ReadIntPtr(IntPtr ptr);

static member ReadIntPtr : nativeint -> nativeint

Public Shared Function ReadIntPtr (ptr As IntPtr) As IntPtr

Parametry

ptr

IntPtr

nativeint

Adresa v nespravované paměti, ze které se má číst.

Návraty

IntPtr

nativeint

Celé číslo přečtené z nespravované paměti. 32bitové celé číslo se vrátí na 32bitových počítačích a 64bitové celé číslo se vrátí na 64bitových počítačích.

Výjimky

AccessViolationException

ptr není rozpoznaný formát.

nebo

ptr je null.

nebo

ptr je neplatný.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadIntPtr a WriteIntPtr metod.

static void ReadWriteIntPtr()
{
    // Allocate unmanaged memory. 
    int elementSize = Marshal.SizeOf(typeof(IntPtr));
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, ((IntPtr)(i + 1)));
    }
    Console.WriteLine("Unmanaged memory written.");

    Console.WriteLine("Reading unmanaged memory:");
    // Print the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Poznámky

ReadIntPtr má implicitní posun 0. Tato metoda umožňuje přímou interakci s nespravovaným polem ve stylu IntPtr jazyka C a eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot prvků.

Čtení z nerovnaných umístění paměti se podporuje.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)