Freigeben über


Marshal.ReadInt16 Methode

Definition

Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher. Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Überlädt

ReadInt16(IntPtr)

Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher.

ReadInt16(IntPtr, Int32)

Liest eine 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.

ReadInt16(Object, Int32)
Veraltet.

Liest eine 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.

ReadInt16(IntPtr)

Quelle:
Marshal.cs
Quelle:
Marshal.cs
Quelle:
Marshal.cs

Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem nicht verwalteten Speicher.

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

Parameter

ptr
IntPtr

nativeint

Die Adresse im nicht verwalteten Speicher, an der gelesen werden soll.

Gibt zurück

Die 16-Bit-Ganzzahl mit Vorzeichen, die aus dem nicht verwalteten Speicher gelesen wurde.

Attribute

Ausnahmen

ptr ist kein erkanntes Format.

- oder -

ptr ist null.

- oder -

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit den ReadInt16 Methoden und WriteInt16 lesen und in ein nicht verwaltetes Array schreiben.

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

Im folgenden Beispiel wird veranschaulicht, wie Sie die ReadInt16 -Methode verwenden, um den Wert einer nicht verwalteten short Variablen zu lesen.


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

Hinweise

ReadInt16 weist einen impliziten Offset von 0 auf. Diese Methode ermöglicht die direkte Interaktion mit einem nicht verwalteten Array im C-Stil Int16 , wodurch das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

ReadInt16(IntPtr, Int32)

Quelle:
Marshal.cs
Quelle:
Marshal.cs
Quelle:
Marshal.cs

Liest eine 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.

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

Parameter

ptr
IntPtr

nativeint

Die Basisadresse im nicht verwalteten Speicher, an der gelesen werden soll.

ofs
Int32

Ein zusätzlicher Byteoffset, der dem ptr-Parameter vor dem Lesen hinzugefügt wird.

Gibt zurück

Die 16-Bit-Ganzzahl mit Vorzeichen, die am angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher gelesen wurde.

Attribute

Ausnahmen

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit den ReadInt16 Methoden und WriteInt16 lesen und in ein nicht verwaltetes Array schreiben.

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

Im folgenden Beispiel wird veranschaulicht, wie Sie die ReadInt16 -Methode verwenden, um den Wert einer nicht verwalteten short Variablen zu lesen.


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

Hinweise

ReadInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen seiner Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

ReadInt16(Object, Int32)

Quelle:
Marshal.CoreCLR.cs
Quelle:
Marshal.CoreCLR.cs
Quelle:
Marshal.CoreCLR.cs

Achtung

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

Liest eine 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher.

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

Parameter

ptr
Object

Die Basisadresse im nicht verwalteten Speicher des Quellobjekts.

ofs
Int32

Ein zusätzlicher Byteoffset, der dem ptr-Parameter vor dem Lesen hinzugefügt wird.

Gibt zurück

Die 16-Bit-Ganzzahl mit Vorzeichen, die am angegebenen Offset aus dem nicht verwalteten Arbeitsspeicher gelesen wurde.

Attribute

Ausnahmen

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

ptr ist ein ArrayWithOffset-Objekt. Diese Methode akzeptiert keine ArrayWithOffset-Parameter.

Hinweise

ReadInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen seiner Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für: