Marshal.ReadInt32 Método

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.InteropServices.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

Lee un entero de 32 bits con signo de la memoria no administrada. Se admite la lectura desde ubicaciones de memoria desalineadas.

Sobrecargas

ReadInt32(IntPtr)	Lee un entero de 32 bits con signo de la memoria no administrada.
ReadInt32(IntPtr, Int32)	Lee un entero de 32 bits con signo en un desplazamiento dado de la memoria no administrada.
ReadInt32(Object, Int32)	Obsoleto. Lee un entero de 32 bits con signo en un desplazamiento dado de la memoria no administrada.

ReadInt32(IntPtr)

Lee un entero de 32 bits con signo de la memoria no administrada.

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

Parámetros

ptr

IntPtr

nativeint

Dirección en la memoria no administrada desde la que se va a leer.

Devoluciones

Int32

Entero de 32 bits con signo leído de la memoria no administrada.

Atributos

SecurityCriticalAttribute

Excepciones

AccessViolationException

ptr no es un formato reconocido.

o bien

ptr es null.

o bien

ptr no es válido.

Ejemplos

En el ejemplo siguiente se muestra cómo leer y escribir en una matriz no administrada mediante los ReadInt32 métodos y 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

En el ejemplo siguiente se muestra cómo usar el ReadInt32 método para leer el valor de una variable no administrada int .

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

Comentarios

ReadInt32 tiene un desplazamiento implícito de 0. Este método permite la interacción directa con una matriz de estilo Int32 C no administrada, lo que elimina el gasto de copiar una matriz no administrada completa (mediante Marshal.Copy) en una matriz administrada independiente antes de leer sus valores de elemento.

Se admite la lectura desde ubicaciones de memoria desalineadas.

Consulte también

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

ReadInt32(IntPtr, Int32)

Lee un entero de 32 bits con signo en un desplazamiento dado de la memoria no administrada.

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

Parámetros

ptr

IntPtr

nativeint

Dirección base en la memoria no administrada desde la que se va a leer.

ofs

Int32

Desplazamiento de bytes adicional, que se agrega al parámetro ptr antes de la lectura.

Devoluciones

Int32

Entero de 32 bits con signo leído de la memoria no administrada.

Atributos

SecurityCriticalAttribute

Excepciones

AccessViolationException

La dirección base (ptr) más el byte de desplazamiento (ofs) produce un valor null o una dirección no válida.

Ejemplos

En el ejemplo siguiente se muestra cómo leer y escribir en una matriz no administrada mediante los ReadInt32 métodos y 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

En el ejemplo siguiente se muestra cómo usar el ReadInt32 método para leer el valor de una variable no administrada int .

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

Comentarios

ReadInt32 permite la interacción directa con una matriz firmada de 32 bits no administrada, lo que elimina el gasto de copiar una matriz no administrada completa (mediante Marshal.Copy) en una matriz administrada independiente antes de leer sus valores de elemento.

Se admite la lectura desde ubicaciones de memoria desalineadas.

Consulte también

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

ReadInt32(Object, Int32)

Precaución

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

Lee un entero de 32 bits con signo en un desplazamiento dado de la memoria no administrada.

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

Parámetros

ptr

Object

Dirección base en la memoria no administrada del objeto de origen.

ofs

Int32

Desplazamiento de bytes adicional, que se agrega al parámetro ptr antes de la lectura.

Devoluciones

Int32

Entero de 32 bits con signo leído de la memoria no administrada en el desplazamiento dado.

Atributos

ObsoleteAttribute SecurityCriticalAttribute

Excepciones

AccessViolationException

La dirección base (ptr) más el byte de desplazamiento (ofs) produce un valor null o una dirección no válida.

ArgumentException

ptr es un objeto ArrayWithOffset. Este método no acepta parámetros ArrayWithOffset.

Comentarios

ReadInt32 permite la interacción directa con una matriz firmada de 32 bits no administrada, lo que elimina el gasto de copiar una matriz no administrada completa (mediante Marshal.Copy) en una matriz administrada independiente antes de leer sus valores de elemento.

Se admite la lectura desde ubicaciones de memoria desalineadas.

Consulte también

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