Marshal.WriteInt16 Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Записывает в неуправляемую память 16-битное целое число со знаком. Запись в невыровненные участки памяти поддерживается.

Перегрузки

WriteInt16(IntPtr, Char)	Записывает в неуправляемую память символ в виде 16-битного целого числа.
WriteInt16(IntPtr, Int16)	Записывает в неуправляемую память 16-битное целое число.
WriteInt16(IntPtr, Int32, Char)	Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.
WriteInt16(IntPtr, Int32, Int16)	Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.
WriteInt16(Object, Int32, Char)	Устаревшие.. Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.
WriteInt16(Object, Int32, Int16)	Устаревшие.. Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.

WriteInt16(IntPtr, Char)

Исходный код:

Marshal.cs

Записывает в неуправляемую память символ в виде 16-битного целого числа.

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)

Параметры

ptr

IntPtr

nativeint

Адрес в неуправляемой памяти, по которому производится запись.

val

Char

Значение для записи.

Исключения

AccessViolationException

ptr не является распознаваемым форматом.

-или-

ptr имеет значение null.

-или-

ptr недопустим.

Примеры

В следующем примере показано, как выполнять чтение и запись в неуправляемый массив с помощью ReadInt16 методов и 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

Комментарии

WriteInt16 обеспечивает прямое взаимодействие с неуправляемым 16-разрядным массивом со знаком, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив перед установкой значений его элементов.

Запись в невыровненные участки памяти поддерживается.

См. также раздел

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

WriteInt16(IntPtr, Int16)

Исходный код:

Marshal.cs

Записывает в неуправляемую память 16-битное целое число.

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)

Параметры

ptr

IntPtr

nativeint

Адрес в неуправляемой памяти, по которому производится запись.

val

Int16

Значение для записи.

Исключения

AccessViolationException

ptr не является распознаваемым форматом.

-или-

ptr имеет значение null.

-или-

ptr недопустим.

Примеры

В следующем примере показано, как выполнять чтение и запись в неуправляемый массив с помощью ReadInt16 методов и 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

Комментарии

WriteInt16 обеспечивает прямое взаимодействие с неуправляемым 16-разрядным массивом со знаком, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив перед установкой значений его элементов.

Запись в невыровненные участки памяти поддерживается.

См. также раздел

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

WriteInt16(IntPtr, Int32, Char)

Исходный код:

Marshal.cs

Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.

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)

Параметры

ptr

IntPtr

nativeint

Базовый адрес для записи в собственной куче.

ofs

Int32

Дополнительное смещение байтов, добавляемое к параметру ptr перед записью.

val

Char

Значение для записи.

Исключения

AccessViolationException

Сумма базового адреса (ptr) и байта смещения (ofs) дает значение null или недопустимый адрес.

Примеры

В следующем примере показано, как выполнять чтение и запись в неуправляемый массив с помощью ReadInt16 методов и 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

Комментарии

WriteInt16 обеспечивает прямое взаимодействие с неуправляемым 16-разрядным массивом со знаком, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив перед установкой значений его элементов.

Запись в невыровненные участки памяти поддерживается.

См. также раздел

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

WriteInt16(IntPtr, Int32, Int16)

Исходный код:

Marshal.cs

Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.

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)

Параметры

ptr

IntPtr

nativeint

Базовый адрес для записи в неуправляемой памяти.

ofs

Int32

Дополнительное смещение байтов, добавляемое к параметру ptr перед записью.

val

Int16

Значение для записи.

Исключения

AccessViolationException

Сумма базового адреса (ptr) и байта смещения (ofs) дает значение null или недопустимый адрес.

Примеры

В следующем примере показано, как выполнять чтение и запись в неуправляемый массив с помощью ReadInt16 методов и 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

Комментарии

WriteInt16 обеспечивает прямое взаимодействие с неуправляемым 16-разрядным массивом со знаком, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив перед установкой значений его элементов.

Запись в невыровненные участки памяти поддерживается.

См. также раздел

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

WriteInt16(Object, Int32, Char)

Исходный код:

Marshal.cs

Внимание!

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

Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.

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)

Параметры

ptr

Object

Базовый адрес конечного объекта в неуправляемой памяти.

ofs

Int32

Дополнительное смещение байтов, добавляемое к параметру ptr перед записью.

val

Char

Значение для записи.

Атрибуты

ObsoleteAttribute

Исключения

AccessViolationException

Сумма базового адреса (ptr) и байта смещения (ofs) дает значение null или недопустимый адрес.

ArgumentException

Параметр ptr является объектом ArrayWithOffset. Этот метод не принимает параметры ArrayWithOffset.

Комментарии

WriteInt16 обеспечивает прямое взаимодействие с неуправляемым 16-разрядным массивом со знаком, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив перед установкой значений его элементов.

Запись в невыровненные участки памяти поддерживается.

См. также раздел

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

WriteInt16(Object, Int32, Int16)

Исходный код:

Marshal.CoreCLR.cs

Внимание!

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

Записывает 16-битное целое число со знаком в неуправляемую память с указанным смещением.

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)

Параметры

ptr

Object

Базовый адрес конечного объекта в неуправляемой памяти.

ofs

Int32

Дополнительное смещение байтов, добавляемое к параметру ptr перед записью.

val

Int16

Значение для записи.

Атрибуты

ObsoleteAttribute

Исключения

AccessViolationException

Сумма базового адреса (ptr) и байта смещения (ofs) дает значение null или недопустимый адрес.

ArgumentException

Параметр ptr является объектом ArrayWithOffset. Этот метод не принимает параметры ArrayWithOffset.

Комментарии

WriteInt16 обеспечивает прямое взаимодействие с неуправляемым 16-разрядным массивом со знаком, устраняя затраты на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив перед установкой значений его элементов.

Запись в невыровненные участки памяти поддерживается.

См. также раздел

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