Marshal.WriteInt16 Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti. Zápis do nezarovnaných paměťových umístění se podporuje.

Přetížení

WriteInt16(IntPtr, Char)	Zapíše znak jako 16bitovou celočíselnou hodnotu do nespravované paměti.
WriteInt16(IntPtr, Int16)	Zapíše 16bitovou celočíselnou hodnotu do nespravované paměti.
WriteInt16(IntPtr, Int32, Char)	Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.
WriteInt16(IntPtr, Int32, Int16)	Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.
WriteInt16(Object, Int32, Char)	Zastaralé. Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.
WriteInt16(Object, Int32, Int16)	Zastaralé. Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.

WriteInt16(IntPtr, Char)

Zdroj:

Marshal.cs

Zapíše znak jako 16bitovou celočíselnou hodnotu do nespravované paměti.

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

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

static member WriteInt16 : nativeint * char -> unit

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

Parametry

ptr

IntPtr

nativeint

Adresa v nespravované paměti, na kterou se má zapisovat.

val

Char

Hodnota pro zápis

Výjimky

AccessViolationException

ptr není rozpoznaný formát.

-nebo-

ptr je null.

-nebo-

Formát ptr je neplatný.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadInt16 metod a WriteInt16 .

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

Poznámky

WriteInt16 umožňuje přímou interakci s nespravovaným 16bitovým polem se znaménkem, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot prvků.

Zápis do nezarovnaných paměťových umístění se podporuje.

Viz také

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

WriteInt16(IntPtr, Int16)

Zdroj:

Marshal.cs

Zapíše 16bitovou celočíselnou hodnotu do nespravované paměti.

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

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

static member WriteInt16 : nativeint * int16 -> unit

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

Parametry

ptr

IntPtr

nativeint

Adresa v nespravované paměti, na kterou se má zapisovat.

val

Int16

Hodnota pro zápis

Výjimky

AccessViolationException

ptr není rozpoznaný formát.

-nebo-

ptr je null.

-nebo-

Formát ptr je neplatný.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadInt16 metod a WriteInt16 .

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

Poznámky

WriteInt16 umožňuje přímou interakci s nespravovaným 16bitovým polem se znaménkem, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot prvků.

Zápis do nezarovnaných paměťových umístění se podporuje.

Viz také

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

WriteInt16(IntPtr, Int32, Char)

Zdroj:

Marshal.cs

Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.

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

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

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

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

Parametry

ptr

IntPtr

nativeint

Základní adresa v nativní haldě, na kterou se má zapisovat.

ofs

Int32

Další posun bajtů, který se přidá do parametru před zápisem ptr .

val

Char

Hodnota pro zápis

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadInt16 metod a WriteInt16 .

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

Poznámky

WriteInt16 umožňuje přímou interakci s nespravovaným 16bitovým polem se znaménkem, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot prvků.

Zápis do nezarovnaných paměťových umístění se podporuje.

Viz také

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

WriteInt16(IntPtr, Int32, Int16)

Zdroj:

Marshal.cs

Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.

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

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

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

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

Parametry

ptr

IntPtr

nativeint

Základní adresa v nespravované paměti, na kterou se má zapisovat.

ofs

Int32

Další posun bajtů, který se přidá do parametru před zápisem ptr .

val

Int16

Hodnota pro zápis

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadInt16 metod a WriteInt16 .

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

Poznámky

WriteInt16 umožňuje přímou interakci s nespravovaným 16bitovým polem se znaménkem, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot prvků.

Zápis do nezarovnaných paměťových umístění se podporuje.

Viz také

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

WriteInt16(Object, Int32, Char)

Zdroj:

Marshal.cs

Upozornění

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

Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.

public:
 static void WriteInt16(System::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);

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

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

Parametry

ptr

Object

Základní adresa v nespravované paměti cílového objektu.

ofs

Int32

Další posun bajtů, který se přidá do parametru před zápisem ptr .

val

Char

Hodnota pro zápis

Atributy

ObsoleteAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

ArgumentException

ptrArrayWithOffset je objekt. Tato metoda nepřijímá ArrayWithOffset parametry.

Poznámky

WriteInt16 umožňuje přímou interakci s nespravovaným 16bitovým polem se znaménkem, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot prvků.

Zápis do nezarovnaných paměťových umístění se podporuje.

Viz také

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

WriteInt16(Object, Int32, Int16)

Zdroj:

Marshal.CoreCLR.cs

Upozornění

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

Zapíše 16bitovou celočíselnou hodnotu se znaménkem do nespravované paměti při zadaném posunu.

public:
 static void WriteInt16(System::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);

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

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

Parametry

ptr

Object

Základní adresa v nespravované paměti cílového objektu.

ofs

Int32

Další posun bajtů, který se přidá do parametru před zápisem ptr .

val

Int16

Hodnota pro zápis

Atributy

ObsoleteAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

ArgumentException

ptrArrayWithOffset je objekt. Tato metoda nepřijímá ArrayWithOffset parametry.

Poznámky

WriteInt16 umožňuje přímou interakci s nespravovaným 16bitovým polem se znaménkem, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot prvků.

Zápis do nezarovnaných paměťových umístění se podporuje.

Viz také

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