Marshal.ReadInt32 Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Načte 32bitové celé číslo se znaménkem z nespravované paměti. Čtení z nerovnaných umístění paměti se podporuje.

Přetížení

Name	Description
ReadInt32(IntPtr)	Načte 32bitové celé číslo se znaménkem z nespravované paměti.
ReadInt32(IntPtr, Int32)	Načte 32bitové celé číslo se znaménkem na daném posunu od nespravované paměti.
ReadInt32(Object, Int32)	Zastaralé. Načte 32bitové celé číslo se znaménkem na daném posunu od nespravované paměti.

ReadInt32(IntPtr)

Zdroj:

Marshal.cs

Načte 32bitové celé číslo se znaménkem z nespravované paměti.

public:
 static int ReadInt32(IntPtr ptr);

public static int ReadInt32(IntPtr ptr);

static member ReadInt32 : nativeint -> int

Public Shared Function ReadInt32 (ptr As IntPtr) As Integer

Parametry

ptr

IntPtr

nativeint

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

Návraty

Int32

32bitové celé číslo se znaménkem čte z nespravované paměti.

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í ReadInt32 a WriteInt32 metod.

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

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt32(unmanagedArray, i * elementSize, ((Int32)(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.ReadInt32(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    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.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    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.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

Následující příklad ukazuje, jak použít metodu ReadInt32 ke čtení hodnoty nespravované int proměnné.

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged integer.
    int myVal = 42;

    // Read the int as a managed Int32.
        Int32 ^ myManagedVal = Marshal::ReadInt32((IntPtr) &myVal);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Poznámky

ReadInt32 má implicitní posun 0. Tato metoda umožňuje přímou interakci s nespravovaným polem ve stylu Int32 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)

ReadInt32(IntPtr, Int32)

Zdroj:

Marshal.cs

Načte 32bitové celé číslo se znaménkem na daném posunu od nespravované paměti.

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

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

static member ReadInt32 : nativeint * int -> int

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

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

Int32

32bitové celé číslo se znaménkem čte z nespravované paměti.

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í ReadInt32 a WriteInt32 metod.

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

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt32(unmanagedArray, i * elementSize, ((Int32)(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.ReadInt32(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    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.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    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.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

Následující příklad ukazuje, jak použít metodu ReadInt32 ke čtení hodnoty nespravované int proměnné.

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged int pointer.
    int * myVal;
    int tmp = 42;
    // Initialize it to another value.
    myVal = &tmp;

    // Read value as a managed Int32.
    Int32 ^ myManagedVal = Marshal::ReadInt32((IntPtr) myVal, 0);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Poznámky

ReadInt32 umožňuje přímou interakci s nespravovaným 32bitovým polem se znaménkem 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)

ReadInt32(Object, Int32)

Zdroj:

Marshal.CoreCLR.cs

Upozornění

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

Načte 32bitové celé číslo se znaménkem na daném posunu od nespravované paměti.

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

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

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

Public Shared Function ReadInt32 (ptr As Object, ofs As Integer) As Integer

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

Int32

32bitové celé číslo se znaménkem načítá 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

ReadInt32 umožňuje přímou interakci s nespravovaným 32bitovým polem se znaménkem 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)