Marshal.ReadInt16 Метод

Ссылка

Определение

Пространство имен:: System.Runtime.InteropServices

Сборка:: System.Runtime.InteropServices.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Считывает из неуправляемой памяти 16-битное целое число со знаком. Чтение из невыровненных участков памяти поддерживается.

Перегрузки

ReadInt16(IntPtr)	Считывает из неуправляемой памяти 16-битное целое число со знаком.
ReadInt16(IntPtr, Int32)	Считывает из неуправляемой памяти с указанным смещением 16-битное целое число со знаком.
ReadInt16(Object, Int32)	Является устаревшей. Считывает из неуправляемой памяти с указанным смещением 16-битное целое число со знаком.

ReadInt16(IntPtr)

Считывает из неуправляемой памяти 16-битное целое число со знаком.

public:
 static short ReadInt16(IntPtr ptr);

[System.Security.SecurityCritical]
public static short ReadInt16 (IntPtr ptr);

public static short ReadInt16 (IntPtr ptr);

[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint -> int16

static member ReadInt16 : nativeint -> int16

Public Shared Function ReadInt16 (ptr As IntPtr) As Short

Параметры

ptr: IntPtr
nativeint

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

Возвращаемое значение

Int16

16-битное целое число со знаком, считанное из неуправляемой памяти.

Атрибуты: SecurityCriticalAttribute

Исключения

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

В следующем примере показано, как использовать ReadInt16 метод для чтения значения неуправляемой short переменной.


using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged short.
    short myShort = 42;

    // Read the short as a managed Int16.
        Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) &myShort);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

ReadInt16 имеет подразумеваемое смещение 0. Этот метод позволяет напрямую взаимодействовать с неуправляемым массивом в стиле Int16 C, устраняя расходы на копирование всего неуправляемого массива (с помощью Marshal.Copy) в отдельный управляемый массив перед чтением значений его элементов.

Чтение из невыровненных участков памяти поддерживается.

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

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

Применяется к

ReadInt16(IntPtr, Int32)

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

public:
 static short ReadInt16(IntPtr ptr, int ofs);

[System.Security.SecurityCritical]
public static short ReadInt16 (IntPtr ptr, int ofs);

public static short ReadInt16 (IntPtr ptr, int ofs);

[<System.Security.SecurityCritical>]
static member ReadInt16 : nativeint * int -> int16

static member ReadInt16 : nativeint * int -> int16

Public Shared Function ReadInt16 (ptr As IntPtr, ofs As Integer) As Short

Параметры

ptr: IntPtr
nativeint

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

ofs: Int32

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

Возвращаемое значение

Int16

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

Атрибуты: SecurityCriticalAttribute

Исключения

AccessViolationException

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

Примеры

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


using namespace System;
using namespace System::Runtime::InteropServices;

void main()
{
    // Create an unmanaged short pointer.
    short * myShort;
    short tmp = 42;
    // Initialize it to another value.
    myShort = &tmp;

    // Read value as a managed Int16.
    Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) myShort, 0);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

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

Чтение из невыровненных участков памяти поддерживается.

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

Применяется к

ReadInt16(Object, Int32)

Внимание!

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

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

public:
 static short ReadInt16(System::Object ^ ptr, int ofs);

[System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static short ReadInt16 (object ptr, int ofs);

[System.Obsolete("ReadInt16(Object, Int32) may be unavailable in future releases.")]
public static short ReadInt16 (object ptr, int ofs);

public static short ReadInt16 (object ptr, int ofs);

[System.Security.SecurityCritical]
public static short ReadInt16 (object ptr, int ofs);

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

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

static member ReadInt16 : obj * int -> int16

[<System.Security.SecurityCritical>]
static member ReadInt16 : obj * int -> int16

Public Shared Function ReadInt16 (ptr As Object, ofs As Integer) As Short

Параметры

ptr: Object

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

ofs: Int32

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

Возвращаемое значение

Int16

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

Атрибуты: ObsoleteAttribute SecurityCriticalAttribute

Исключения

AccessViolationException

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

ArgumentException

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

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

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

Применяется к

Marshal.ReadInt16 Метод

Определение

Перегрузки

ReadInt16(IntPtr)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Применяется к

ReadInt16(IntPtr, Int32)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

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

Применяется к

ReadInt16(Object, Int32)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

Применяется к

Дополнительные ресурсы