Marshal.WriteInt16 Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Zapisuje 16-bitową wartość całkowitą ze znakiem do niezarządzanej pamięci. Zapisywanie w nieprzypisanych lokalizacjach pamięci jest obsługiwane.

Przeciążenia

WriteInt16(IntPtr, Char)	Zapisuje znak jako 16-bitową wartość całkowitą do niezarządzanej pamięci.
WriteInt16(IntPtr, Int16)	Zapisuje 16-bitową wartość całkowitą w pamięci niezarządzanej.
WriteInt16(IntPtr, Int32, Char)	Zapisuje 16-bitową wartość całkowitą z podpisem do niezarządzanej pamięci w określonym przesunięciu.
WriteInt16(IntPtr, Int32, Int16)	Zapisuje 16-bitową wartość całkowitą ze znakiem w niezarządzanej pamięci przy określonym przesunięciu.
WriteInt16(Object, Int32, Char)	Przestarzałe. Zapisuje 16-bitową wartość całkowitą z podpisem do niezarządzanej pamięci w określonym przesunięciu.
WriteInt16(Object, Int32, Int16)	Przestarzałe. Zapisuje 16-bitową wartość całkowitą z podpisem do niezarządzanej pamięci w określonym przesunięciu.

WriteInt16(IntPtr, Char)

Źródło:

Marshal.cs

Zapisuje znak jako 16-bitową wartość całkowitą do niezarządzanej pamięci.

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

Adres w pamięci niezarządzanej do zapisu.

val

Char

Wartość do zapisu.

Wyjątki

AccessViolationException

ptr nie jest rozpoznanym formatem.

-lub-

ptr to null.

-lub-

Nazwa ptr jest niepoprawna.

Przykłady

W poniższym przykładzie pokazano, jak odczytywać i zapisywać w tablicy niezarządzanej przy użyciu ReadInt16 metod i 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

Uwagi

WriteInt16 umożliwia bezpośrednią interakcję z niezarządzaną 16-bitową tablicą podpisaną, eliminując koszt kopiowania całej tablicy niezarządzanej (przy użyciu metody Marshal.Copy) do oddzielnej tablicy zarządzanej przed ustawieniem jego wartości elementów.

Zapisywanie w nieprzypisanych lokalizacjach pamięci jest obsługiwane.

Zobacz też

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

WriteInt16(IntPtr, Int16)

Źródło:

Marshal.cs

Zapisuje 16-bitową wartość całkowitą w pamięci niezarządzanej.

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

Adres w pamięci niezarządzanej do zapisu.

val

Int16

Wartość do zapisu.

Wyjątki

AccessViolationException

ptr nie jest rozpoznanym formatem.

-lub-

ptr to null.

-lub-

Nazwa ptr jest niepoprawna.

Przykłady

W poniższym przykładzie pokazano, jak odczytywać i zapisywać w tablicy niezarządzanej przy użyciu ReadInt16 metod i 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

Uwagi

WriteInt16 umożliwia bezpośrednią interakcję z niezarządzaną 16-bitową tablicą podpisaną, eliminując koszt kopiowania całej tablicy niezarządzanej (przy użyciu metody Marshal.Copy) do oddzielnej tablicy zarządzanej przed ustawieniem jego wartości elementów.

Zapisywanie w nieprzypisanych lokalizacjach pamięci jest obsługiwane.

Zobacz też

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

WriteInt16(IntPtr, Int32, Char)

Źródło:

Marshal.cs

Zapisuje 16-bitową wartość całkowitą z podpisem do niezarządzanej pamięci w określonym przesunięciu.

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

Adres podstawowy w stercie natywnej do zapisu.

ofs

Int32

Dodatkowe przesunięcie bajtów, które jest dodawane do parametru przed zapisem ptr .

val

Char

Wartość do zapisu.

Wyjątki

AccessViolationException

Adres podstawowy () plus bajt przesunięcia (ptrofs) tworzy adres o wartości null lub nieprawidłowy.

Przykłady

W poniższym przykładzie pokazano, jak odczytywać i zapisywać w tablicy niezarządzanej przy użyciu ReadInt16 metod i 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

Uwagi

WriteInt16 umożliwia bezpośrednią interakcję z niezarządzaną 16-bitową tablicą podpisaną, eliminując koszt kopiowania całej tablicy niezarządzanej (przy użyciu metody Marshal.Copy) do oddzielnej tablicy zarządzanej przed ustawieniem jego wartości elementów.

Zapisywanie w nieprzypisanych lokalizacjach pamięci jest obsługiwane.

Zobacz też

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

WriteInt16(IntPtr, Int32, Int16)

Źródło:

Marshal.cs

Zapisuje 16-bitową wartość całkowitą ze znakiem w niezarządzanej pamięci przy określonym przesunięciu.

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

Adres podstawowy w pamięci niezarządzanej do zapisu.

ofs

Int32

Dodatkowe przesunięcie bajtów, które jest dodawane do parametru przed zapisem ptr .

val

Int16

Wartość do zapisu.

Wyjątki

AccessViolationException

Adres podstawowy () plus bajt przesunięcia (ptrofs) tworzy adres o wartości null lub nieprawidłowy.

Przykłady

W poniższym przykładzie pokazano, jak odczytywać i zapisywać w tablicy niezarządzanej przy użyciu ReadInt16 metod i 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

Uwagi

WriteInt16 umożliwia bezpośrednią interakcję z niezarządzaną 16-bitową tablicą podpisaną, eliminując koszt kopiowania całej tablicy niezarządzanej (przy użyciu metody Marshal.Copy) do oddzielnej tablicy zarządzanej przed ustawieniem jego wartości elementów.

Zapisywanie w nieprzypisanych lokalizacjach pamięci jest obsługiwane.

Zobacz też

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

WriteInt16(Object, Int32, Char)

Źródło:

Marshal.cs

Przestroga

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

Zapisuje 16-bitową wartość całkowitą z podpisem do niezarządzanej pamięci w określonym przesunięciu.

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

Adres podstawowy w niezarządzanej pamięci obiektu docelowego.

ofs

Int32

Dodatkowe przesunięcie bajtów, które jest dodawane do parametru przed zapisem ptr .

val

Char

Wartość do zapisu.

Atrybuty

ObsoleteAttribute

Wyjątki

AccessViolationException

Adres podstawowy () plus bajt przesunięcia (ptrofs) tworzy adres o wartości null lub nieprawidłowy.

ArgumentException

ptr jest obiektem ArrayWithOffset . Ta metoda nie akceptuje ArrayWithOffset parametrów.

Uwagi

WriteInt16 umożliwia bezpośrednią interakcję z niezarządzaną 16-bitową tablicą podpisaną, eliminując koszt kopiowania całej tablicy niezarządzanej (przy użyciu metody Marshal.Copy) do oddzielnej tablicy zarządzanej przed ustawieniem jego wartości elementów.

Zapisywanie w nieprzypisanych lokalizacjach pamięci jest obsługiwane.

Zobacz też

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

WriteInt16(Object, Int32, Int16)

Źródło:

Marshal.CoreCLR.cs

Przestroga

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

Zapisuje 16-bitową wartość całkowitą z podpisem do niezarządzanej pamięci w określonym przesunięciu.

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

Adres podstawowy w niezarządzanej pamięci obiektu docelowego.

ofs

Int32

Dodatkowe przesunięcie bajtów, które jest dodawane do parametru przed zapisem ptr .

val

Int16

Wartość do zapisu.

Atrybuty

ObsoleteAttribute

Wyjątki

AccessViolationException

Adres podstawowy () plus bajt przesunięcia (ptrofs) tworzy adres o wartości null lub nieprawidłowy.

ArgumentException

ptr jest obiektem ArrayWithOffset . Ta metoda nie akceptuje ArrayWithOffset parametrów.

Uwagi

WriteInt16 umożliwia bezpośrednią interakcję z niezarządzaną 16-bitową tablicą podpisaną, eliminując koszt kopiowania całej tablicy niezarządzanej (przy użyciu metody Marshal.Copy) do oddzielnej tablicy zarządzanej przed ustawieniem jego wartości elementów.

Zapisywanie w nieprzypisanych lokalizacjach pamięci jest obsługiwane.

Zobacz też

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