Marshal.ReadInt16 Método

  • Referencia

Definición

Espacio de nombres:
System.Runtime.InteropServices
Ensamblado:
System.Runtime.InteropServices.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

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

Sobrecargas

ReadInt16(IntPtr)

Lee un entero de 16 bits con signo de la memoria no administrada.
ReadInt16(IntPtr, Int32)

Lee un entero de 16 bits con signo en un desplazamiento dado de la memoria no administrada.
ReadInt16(Object, Int32)
Obsoletos.

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

ReadInt16(IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

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

public:
 static short ReadInt16(IntPtr ptr);
[System.Security.SecurityCritical]
public static short ReadInt16 (IntPtr ptr);
public static short ReadInt16 (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint -> int16
static member ReadInt16 : nativeint -> int16
Public Shared Function ReadInt16 (ptr As IntPtr) As Short

Parámetros

ptr
IntPtr

nativeint

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

Devoluciones

Int16

Entero de 16 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 ReadInt16 métodos y WriteInt16 .

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

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

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(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 ReadInt16 método para leer el valor de una variable no administrada short .


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



void main()
{
    // Create an unmanaged short.
    short myShort = 42;

    // Read the short as a managed Int16.
        Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) &myShort);

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

Comentarios

ReadInt16 tiene un desplazamiento implícito de 0. Este método permite la interacción directa con una matriz de estilo Int16 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

Se aplica a

ReadInt16(IntPtr, Int32)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

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

public:
 static short ReadInt16(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static short ReadInt16 (IntPtr ptr, int ofs);
public static short ReadInt16 (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint * int -> int16
static member ReadInt16 : nativeint * int -> int16
Public Shared Function ReadInt16 (ptr As IntPtr, ofs As Integer) As Short

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

Int16

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

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 ReadInt16 métodos y WriteInt16 .

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

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

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(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 ReadInt16 método para leer el valor de una variable no administrada short .


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

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

    // Read value as a managed Int16.
    Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) myShort, 0);

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

Comentarios

ReadInt16 permite la interacción directa con una matriz firmada de 16 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

Se aplica a

ReadInt16(Object, Int32)

Source:
Marshal.CoreCLR.cs
Source:
Marshal.CoreCLR.cs
Source:
Marshal.CoreCLR.cs

Precaución

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

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

public:
 static short ReadInt16(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static short ReadInt16 (object ptr, int ofs);
[System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")]
public static short ReadInt16 (object ptr, int ofs);
public static short ReadInt16 (object ptr, int ofs);
[System.Security.SecurityCritical]
public static short ReadInt16 (object ptr, int ofs);
[<System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadInt16 : obj * int -> int16
[<System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt16 : obj * int -> int16
static member ReadInt16 : obj * int -> int16
[<System.Security.SecurityCritical>]
static member ReadInt16 : obj * int -> int16
Public Shared Function ReadInt16 (ptr As Object, ofs As Integer) As Short

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

Int16

Entero de 16 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

ReadInt16 permite la interacción directa con una matriz firmada de 16 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

Se aplica a