Marshal.ReadInt16 Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Legge un intero con segno a 16 bit dalla memoria non gestita. La lettura da percorsi di memoria non allineati è supportata.

Overload

Nome	Descrizione
ReadInt16(IntPtr)	Legge un intero con segno a 16 bit dalla memoria non gestita.
ReadInt16(IntPtr, Int32)	Legge un intero con segno a 16 bit in corrispondenza di un offset specificato dalla memoria non gestita.
ReadInt16(Object, Int32)	Legge un intero con segno a 16 bit in corrispondenza di un offset specificato dalla memoria non gestita.

ReadInt16(IntPtr)

Legge un intero con segno a 16 bit dalla memoria non gestita.

public:
 static short ReadInt16(IntPtr ptr);

[System.Security.SecurityCritical]
public static short ReadInt16(IntPtr ptr);

[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint -> int16

Public Shared Function ReadInt16 (ptr As IntPtr) As Short

Parametri

ptr

IntPtr

nativeint

Indirizzo in memoria non gestita da cui leggere.

Valori restituiti

Int16

Intero con segno a 16 bit letto dalla memoria non gestita.

Attributi

SecurityCriticalAttribute

Eccezioni

AccessViolationException

ptr non è un formato riconosciuto.

oppure

ptr è null.

oppure

ptr non è valido.

Esempio

Nell'esempio seguente viene illustrato come leggere e scrivere in una matrice non gestita usando i ReadInt16 metodi e 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

Nell'esempio seguente viene illustrato come utilizzare il ReadInt16 metodo per leggere il valore di una variabile non gestita 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);
}

Commenti

ReadInt16 ha un offset implicito pari a 0. Questo metodo consente l'interazione diretta con una matrice di tipo Int16 C non gestita, eliminando i costi di copia di un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di leggere i relativi valori di elemento.

La lettura da percorsi di memoria non allineati è supportata.

Vedi anche

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

ReadInt16(IntPtr, Int32)

Legge un intero con segno a 16 bit in corrispondenza di un offset specificato dalla memoria non gestita.

public:
 static short ReadInt16(IntPtr ptr, int ofs);

[System.Security.SecurityCritical]
public static short ReadInt16(IntPtr ptr, int ofs);

[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint * int -> int16

Public Shared Function ReadInt16 (ptr As IntPtr, ofs As Integer) As Short

Parametri

ptr

IntPtr

nativeint

Indirizzo di base nella memoria non gestita da cui leggere.

ofs

Int32

Offset di byte aggiuntivo, che viene aggiunto al parametro prima della ptr lettura.

Valori restituiti

Int16

Intero con segno a 16 bit letto dalla memoria non gestita in corrispondenza dell'offset specificato.

Attributi

SecurityCriticalAttribute

Eccezioni

AccessViolationException

L'indirizzo di base (ptr) più byte offset (ofs) produce un indirizzo Null o non valido.

Esempio

Nell'esempio seguente viene illustrato come leggere e scrivere in una matrice non gestita usando i ReadInt16 metodi e 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

Nell'esempio seguente viene illustrato come utilizzare il ReadInt16 metodo per leggere il valore di una variabile non gestita 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);
}

Commenti

ReadInt16 consente l'interazione diretta con una matrice con segno a 16 bit non gestita, eliminando i costi di copia di un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di leggere i relativi valori di elemento.

La lettura da percorsi di memoria non allineati è supportata.

Vedi anche

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

ReadInt16(Object, Int32)

Legge un intero con segno a 16 bit in corrispondenza di un offset specificato dalla memoria non gestita.

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

[System.Security.SecurityCritical]
public static short ReadInt16(object ptr, int ofs);

[<System.Security.SecurityCritical>]
static member ReadInt16 : obj * int -> int16

Public Shared Function ReadInt16 (ptr As Object, ofs As Integer) As Short

Parametri

ptr

Object

Indirizzo di base nella memoria non gestita dell'oggetto di origine.

ofs

Int32

Offset di byte aggiuntivo, che viene aggiunto al parametro prima della ptr lettura.

Valori restituiti

Int16

Intero con segno a 16 bit letto dalla memoria non gestita in corrispondenza dell'offset specificato.

Attributi

SecurityCriticalAttribute

Eccezioni

AccessViolationException

L'indirizzo di base (ptr) più byte offset (ofs) produce un indirizzo Null o non valido.

ArgumentException

ptr è un ArrayWithOffset oggetto . Questo metodo non accetta ArrayWithOffset parametri.

Commenti

ReadInt16 consente l'interazione diretta con una matrice con segno a 16 bit non gestita, eliminando i costi di copia di un'intera matrice non gestita (usando Marshal.Copy) in una matrice gestita separata prima di leggere i relativi valori di elemento.

La lettura da percorsi di memoria non allineati è supportata.

Vedi anche

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