Marshal.ReadInt16 Methode

Definition

Namespace:: System.Runtime.InteropServices

Assemblys:: mscorlib.dll, System.Runtime.InteropServices.dll

Assemblys:: netstandard.dll, System.Runtime.InteropServices.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Liest eine 16-Bit-ganzzahlige Vorzeichen aus nicht verwaltetem Arbeitsspeicher. Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Überlädt

Name	Beschreibung
ReadInt16(IntPtr)	Liest eine 16-Bit-ganzzahlige Vorzeichen aus nicht verwaltetem Arbeitsspeicher.
ReadInt16(IntPtr, Int32)	Liest eine 16-Bit-Ganzzahl mit Vorzeichen bei einem bestimmten Offset aus nicht verwaltetem Speicher.
ReadInt16(Object, Int32)	Veraltet. Liest eine 16-Bit-Ganzzahl mit Vorzeichen bei einem bestimmten Offset aus nicht verwaltetem Speicher.

ReadInt16(IntPtr)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Liest eine 16-Bit-ganzzahlige Vorzeichen aus nicht verwaltetem Arbeitsspeicher.

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, aus dem gelesen werden soll.

Gibt zurück

Int16

Der 16-Bit-ganzzahlige Wert mit Vorzeichen aus nicht verwalteten Arbeitsspeicher.

Attribute: SecurityCriticalAttribute

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

-oder-

ptr ist null.

-oder-

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird das Lesen und Schreiben in ein nicht verwaltetes Array mithilfe der und ReadInt16 der WriteInt16 Methoden veranschaulicht.

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 die ReadInt16 Methode verwendet wird, 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 hat einen implizierten Offset von 0. Diese Methode ermöglicht die direkte Interaktion mit einem nicht verwalteten C-Array Int16 , wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Weitere Informationen

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

Gilt für:

ReadInt16(IntPtr, Int32)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Liest eine 16-Bit-Ganzzahl mit Vorzeichen bei einem bestimmten Offset aus nicht verwaltetem Speicher.

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, aus dem gelesen werden soll.

ofs: Int32

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

Gibt zurück

Int16

Der 16-Bit-ganzzahlige Wert mit Vorzeichen aus nicht verwalteten Speicher beim angegebenen Offset.

Attribute: SecurityCriticalAttribute

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder ungültige Adresse.

Beispiele

Im folgenden Beispiel wird das Lesen und Schreiben in ein nicht verwaltetes Array mithilfe der und ReadInt16 der WriteInt16 Methoden veranschaulicht.

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 die ReadInt16 Methode verwendet wird, 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-signierten Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Weitere Informationen

Gilt für:

ReadInt16(Object, Int32)

Quelle:: Marshal.CoreCLR.cs

Quelle:: Marshal.CoreCLR.cs

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 bei einem bestimmten Offset aus nicht verwaltetem Speicher.

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.")]
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")]
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.")>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")>]
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 Byte-Offset, der dem Parameter vor dem ptr Lesen hinzugefügt wird.

Gibt zurück

Int16

Der 16-Bit-ganzzahlige Wert mit Vorzeichen aus nicht verwalteten Speicher beim angegebenen Offset.

Attribute: ObsoleteAttribute SecurityCriticalAttribute RequiresDynamicCodeAttribute

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder ungültige Adresse.

ArgumentException

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

Hinweise

Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Weitere Informationen

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

Gilt für:

Feedback

War diese Seite hilfreich?