Marshal.WriteInt16 Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Schreibt eine 16-Bit-Ganzzahl mit Vorzeichen in den nicht verwalteten Speicher. Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Überlädt

WriteInt16(IntPtr, Char)	Schreibt ein Zeichen als 16-Bit-Ganzzahl in den nicht verwalteten Speicher.
WriteInt16(IntPtr, Int16)	Schreibt eine 16-Bit-Ganzzahl in den nicht verwalteten Speicher.
WriteInt16(IntPtr, Int32, Char)	Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.
WriteInt16(IntPtr, Int32, Int16)	Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.
WriteInt16(Object, Int32, Char)	Veraltet. Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.
WriteInt16(Object, Int32, Int16)	Veraltet. Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.

WriteInt16(IntPtr, Char)

Schreibt ein Zeichen als 16-Bit-Ganzzahl in den nicht verwalteten Speicher.

public:
 static void WriteInt16(IntPtr ptr, char val);

[System.Security.SecurityCritical]
public static void WriteInt16 (IntPtr ptr, char val);

public static void WriteInt16 (IntPtr ptr, char val);

[<System.Security.SecurityCritical>]
static member WriteInt16 : nativeint * char -> unit

static member WriteInt16 : nativeint * char -> unit

Public Shared Sub WriteInt16 (ptr As IntPtr, val As Char)

Parameter

ptr

IntPtr

nativeint

Die Adresse im nicht verwalteten Speicher, in die geschrieben werden soll.

val

Char

Der zu schreibende Wert.

Attribute

SecurityCriticalAttribute

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

- oder -

ptr ist null.

- oder -

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der ReadInt16 Methoden WriteInt16 ein nicht verwaltetes Array 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

Hinweise

WriteInt16 ermöglicht direkte Interaktion mit einem nicht verwalteten 16-Bit-Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Siehe auch

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

WriteInt16(IntPtr, Int16)

Schreibt eine 16-Bit-Ganzzahl in den nicht verwalteten Speicher.

public:
 static void WriteInt16(IntPtr ptr, short val);

[System.Security.SecurityCritical]
public static void WriteInt16 (IntPtr ptr, short val);

public static void WriteInt16 (IntPtr ptr, short val);

[<System.Security.SecurityCritical>]
static member WriteInt16 : nativeint * int16 -> unit

static member WriteInt16 : nativeint * int16 -> unit

Public Shared Sub WriteInt16 (ptr As IntPtr, val As Short)

Parameter

ptr

IntPtr

nativeint

Die Adresse im nicht verwalteten Speicher, in die geschrieben werden soll.

val

Int16

Der zu schreibende Wert.

Attribute

SecurityCriticalAttribute

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

- oder -

ptr ist null.

- oder -

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der ReadInt16 Methoden WriteInt16 ein nicht verwaltetes Array 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

Hinweise

WriteInt16 ermöglicht direkte Interaktion mit einem nicht verwalteten 16-Bit-Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Siehe auch

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

WriteInt16(IntPtr, Int32, Char)

Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.

public:
 static void WriteInt16(IntPtr ptr, int ofs, char val);

[System.Security.SecurityCritical]
public static void WriteInt16 (IntPtr ptr, int ofs, char val);

public static void WriteInt16 (IntPtr ptr, int ofs, char val);

[<System.Security.SecurityCritical>]
static member WriteInt16 : nativeint * int * char -> unit

static member WriteInt16 : nativeint * int * char -> unit

Public Shared Sub WriteInt16 (ptr As IntPtr, ofs As Integer, val As Char)

Parameter

ptr

IntPtr

nativeint

Die Basisadresse im systemeigenen Heap, in die geschrieben werden soll.

ofs

Int32

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

val

Char

Der zu schreibende Wert.

Attribute

SecurityCriticalAttribute

Ausnahmen

AccessViolationException

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der ReadInt16 Methoden WriteInt16 ein nicht verwaltetes Array 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

Hinweise

WriteInt16 ermöglicht direkte Interaktion mit einem nicht verwalteten 16-Bit-Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Siehe auch

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

WriteInt16(IntPtr, Int32, Int16)

Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.

public:
 static void WriteInt16(IntPtr ptr, int ofs, short val);

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

public static void WriteInt16 (IntPtr ptr, int ofs, short val);

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

static member WriteInt16 : nativeint * int * int16 -> unit

Public Shared Sub WriteInt16 (ptr As IntPtr, ofs As Integer, val As Short)

Parameter

ptr

IntPtr

nativeint

Die Basisadresse im nicht verwalteten Speicher, in die geschrieben werden soll.

ofs

Int32

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

val

Int16

Der zu schreibende Wert.

Attribute

SecurityCriticalAttribute

Ausnahmen

AccessViolationException

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der ReadInt16 Methoden WriteInt16 ein nicht verwaltetes Array 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

Hinweise

WriteInt16 ermöglicht direkte Interaktion mit einem nicht verwalteten 16-Bit-Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Siehe auch

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

WriteInt16(Object, Int32, Char)

Achtung

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

Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.

public:
 static void WriteInt16(System::Object ^ ptr, int ofs, char val);

[System.Obsolete("WriteInt16(Object, Int32, Char) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static void WriteInt16 (object ptr, int ofs, char val);

[System.Obsolete("WriteInt16(Object, Int32, Char) may be unavailable in future releases.")]
public static void WriteInt16 (object ptr, int ofs, char val);

public static void WriteInt16 (object ptr, int ofs, char val);

[System.Security.SecurityCritical]
public static void WriteInt16 (object ptr, int ofs, char val);

[<System.Obsolete("WriteInt16(Object, Int32, Char) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member WriteInt16 : obj * int * char -> unit

[<System.Obsolete("WriteInt16(Object, Int32, Char) may be unavailable in future releases.")>]
static member WriteInt16 : obj * int * char -> unit

static member WriteInt16 : obj * int * char -> unit

[<System.Security.SecurityCritical>]
static member WriteInt16 : obj * int * char -> unit

Public Shared Sub WriteInt16 (ptr As Object, ofs As Integer, val As Char)

Parameter

ptr

Object

Die Basisadresse im nicht verwalteten Speicher des Zielobjekts.

ofs

Int32

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

val

Char

Der zu schreibende Wert.

Attribute

ObsoleteAttribute SecurityCriticalAttribute

Ausnahmen

AccessViolationException

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

ArgumentException

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

Hinweise

WriteInt16 ermöglicht direkte Interaktion mit einem nicht verwalteten 16-Bit-Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Siehe auch

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

WriteInt16(Object, Int32, Int16)

Achtung

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

Schreibt den Wert einer 16-Bit-Ganzzahl mit Vorzeichen an einem angegebenen Offset in den nicht verwalteten Speicher.

public:
 static void WriteInt16(System::Object ^ ptr, int ofs, short val);

[System.Obsolete("WriteInt16(Object, Int32, Int16) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static void WriteInt16 (object ptr, int ofs, short val);

[System.Obsolete("WriteInt16(Object, Int32, Int16) may be unavailable in future releases.")]
public static void WriteInt16 (object ptr, int ofs, short val);

public static void WriteInt16 (object ptr, int ofs, short val);

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

[<System.Obsolete("WriteInt16(Object, Int32, Int16) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member WriteInt16 : obj * int * int16 -> unit

[<System.Obsolete("WriteInt16(Object, Int32, Int16) may be unavailable in future releases.")>]
static member WriteInt16 : obj * int * int16 -> unit

static member WriteInt16 : obj * int * int16 -> unit

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

Public Shared Sub WriteInt16 (ptr As Object, ofs As Integer, val As Short)

Parameter

ptr

Object

Die Basisadresse im nicht verwalteten Speicher des Zielobjekts.

ofs

Int32

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

val

Int16

Der zu schreibende Wert.

Attribute

ObsoleteAttribute SecurityCriticalAttribute

Ausnahmen

AccessViolationException

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

ArgumentException

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

Hinweise

WriteInt16 ermöglicht direkte Interaktion mit einem nicht verwalteten 16-Bit-Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Siehe auch

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