Sdílet prostřednictvím

Marshal.ReadInt32 Metoda

  • Reference

Definice

Obor názvů:
System.Runtime.InteropServices
Sestavení:
System.Runtime.InteropServices.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Čte celé číslo se 32bitovým znaménkem z nespravované paměti. Čtení z nezarovnaných paměťových umístění je podporováno.

Přetížení

ReadInt32(IntPtr)

Čte celé číslo se 32bitovým znaménkem z nespravované paměti.
ReadInt32(IntPtr, Int32)

Čte celé číslo se 32bitovým znaménkem v daném posunu od nespravované paměti.
ReadInt32(Object, Int32)
Zastaralé.

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

ReadInt32(IntPtr)

Zdroj:
Marshal.cs
Zdroj:
Marshal.cs
Zdroj:
Marshal.cs

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

public:
 static int ReadInt32(IntPtr ptr);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr);
public static int ReadInt32 (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint -> int
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 přečtené z nespravované paměti.

Atributy
SecurityCriticalAttribute

Výjimky

AccessViolationException

ptr není rozpoznaný formát.

-nebo-

ptr je null.

-nebo-

Formát ptr je neplatný.

Příklady

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

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 C, čímž 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 jeho prvků.

Čtení z nezarovnaných paměťových umístění je podporováno.

Viz také

Platí pro

ReadInt32(IntPtr, Int32)

Zdroj:
Marshal.cs
Zdroj:
Marshal.cs
Zdroj:
Marshal.cs

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

public:
 static int ReadInt32(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr, int ofs);
public static int ReadInt32 (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint * int -> int
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 bajtů, který se přidá do parametru ptr před čtením.

Návraty

Int32

32bitové celé číslo se znaménkem přečtené z nespravované paměti.

Atributy
SecurityCriticalAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

Příklady

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

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, čímž 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 jeho prvků.

Čtení z nezarovnaných paměťových umístění je podporováno.

Viz také

Platí pro

ReadInt32(Object, Int32)

Zdroj:
Marshal.CoreCLR.cs
Zdroj:
Marshal.CoreCLR.cs
Zdroj:
Marshal.CoreCLR.cs

Upozornění

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

Čte celé číslo se 32bitovým znaménkem v 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.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")]
public static int ReadInt32 (object ptr, int ofs);
public static int ReadInt32 (object ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt32 : obj * int -> int
static member ReadInt32 : obj * int -> int
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
Public Shared Function ReadInt32 (ptr As Object, ofs As Integer) As Integer

Parametry

ptr
Object

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

ofs
Int32

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

Návraty

Int32

32bitové celé číslo se znaménkem přečte z nespravované paměti při daném posunu.

Atributy
ObsoleteAttribute SecurityCriticalAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

ArgumentException

ptrArrayWithOffset 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, čímž 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 jeho prvků.

Čtení z nezarovnaných paměťových umístění je podporováno.

Viz také

Platí pro