Auf Englisch lesen

Freigeben über


Marshal.WriteInt16 Methode

Definition

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)

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

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

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

Parameter

ptr
IntPtr

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

val
Char

Der zu schreibende Wert.

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.

C#
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();
}

Hinweise

WriteInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteInt16(IntPtr, Int16)

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

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

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

Parameter

ptr
IntPtr

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

val
Int16

Der zu schreibende Wert.

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.

C#
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();
}

Hinweise

WriteInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteInt16(IntPtr, Int32, Char)

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

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

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

Parameter

ptr
IntPtr

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

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.

C#
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();
}

Hinweise

WriteInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteInt16(IntPtr, Int32, Int16)

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

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

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

Parameter

ptr
IntPtr

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

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.

C#
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();
}

Hinweise

WriteInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

WriteInt16(Object, Int32, Char)

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

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.

C#
[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);
C#
[System.Obsolete("WriteInt16(Object, Int32, Char) may be unavailable in future releases.")]
public static void WriteInt16(object ptr, int ofs, char val);
C#
public static void WriteInt16(object ptr, int ofs, char val);
C#
[System.Security.SecurityCritical]
public static void WriteInt16(object ptr, int ofs, char val);

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

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

WriteInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen (Veraltet)
.NET (Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 (4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided))
.NET Standard 1.1, 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP (10.0)

WriteInt16(Object, Int32, Int16)

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

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.

C#
[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);
C#
[System.Obsolete("WriteInt16(Object, Int32, Int16) may be unavailable in future releases.")]
public static void WriteInt16(object ptr, int ofs, short val);
C#
public static void WriteInt16(object ptr, int ofs, short val);
C#
[System.Security.SecurityCritical]
public static void WriteInt16(object ptr, int ofs, short val);

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

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

WriteInt16 ermöglicht die direkte Interaktion mit einem nicht verwalteten 16-Bit-Array mit Vorzeichen, wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Festlegen der Elementwerte entfällt.

Das Schreiben in nicht ausgerichtete Speicheradressen wird unterstützt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen (Veraltet)
.NET (Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 (4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided))
.NET Standard 1.1, 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP (10.0)