Marshal.WriteInt16 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.

Schreibt einen ganzzahligen 16-Bit-Wert mit Vorzeichen in nicht verwalteten Arbeitsspeicher. Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Überlädt

Name	Beschreibung
WriteInt16(IntPtr, Char)	Schreibt ein Zeichen als ganzzahliger 16-Bit-Wert in nicht verwalteten Arbeitsspeicher.
WriteInt16(IntPtr, Int16)	Schreibt einen ganzzahligen 16-Bit-Wert in nicht verwalteten Arbeitsspeicher.
WriteInt16(IntPtr, Int32, Char)	Schreibt einen ganzzahligen 16-Bit-Ganzzahlwert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.
WriteInt16(IntPtr, Int32, Int16)	Schreibt einen ganzzahligen 16-Bit-Wert mit Vorzeichen in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.
WriteInt16(Object, Int32, Char)	Veraltet. Schreibt einen ganzzahligen 16-Bit-Ganzzahlwert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.
WriteInt16(Object, Int32, Int16)	Veraltet. Schreibt einen ganzzahligen 16-Bit-Ganzzahlwert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.

WriteInt16(IntPtr, Char)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Schreibt ein Zeichen als ganzzahliger 16-Bit-Wert in nicht verwalteten Arbeitsspeicher.

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 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

Hinweise

WriteInt16 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 festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

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

Gilt für:

WriteInt16(IntPtr, Int16)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Schreibt einen ganzzahligen 16-Bit-Wert in nicht verwalteten Arbeitsspeicher.

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 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

Hinweise

Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

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

Gilt für:

WriteInt16(IntPtr, Int32, Char)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Schreibt einen ganzzahligen 16-Bit-Ganzzahlwert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.

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 Byte-Offset, der dem Parameter vor dem ptr Schreiben hinzugefügt wird.

val: Char

Der zu schreibende Wert.

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

Hinweise

Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

Gilt für:

WriteInt16(IntPtr, Int32, Int16)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Schreibt einen ganzzahligen 16-Bit-Wert mit Vorzeichen in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.

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 Arbeitsspeicher, in die geschrieben werden soll.

ofs: Int32

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

val: Int16

Der zu schreibende Wert.

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

Hinweise

Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

Gilt für:

WriteInt16(Object, Int32, Char)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Achtung

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

Schreibt einen ganzzahligen 16-Bit-Ganzzahlwert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.

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

val: Char

Der zu schreibende Wert.

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 Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

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

Gilt für:

WriteInt16(Object, Int32, Int16)

Quelle:: Marshal.CoreCLR.cs

Quelle:: Marshal.CoreCLR.cs

Quelle:: Marshal.CoreCLR.cs

Quelle:: Marshal.CoreCLR.cs

Quelle:: Marshal.CoreCLR.cs

Achtung

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

Schreibt einen ganzzahligen 16-Bit-Ganzzahlwert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.

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

val: Int16

Der zu schreibende Wert.

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 Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

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

Gilt für:

Feedback

War diese Seite hilfreich?