Marshal.ReadInt16 方法

参考

定义

命名空间:: System.Runtime.InteropServices

程序集:: System.Runtime.InteropServices.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

从非托管内存中读取一个 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 的默示偏移量。此方法可实现与非托管 C 样式 Int16 数组的直接交互，无需在读取其元素值之前使用 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) 可产生空或无效地址。

示例

下面的示例演示如何使用 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 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) 可产生空或无效地址。

ArgumentException

ptr 是 ArrayWithOffset 对象。此方法不接受 ArrayWithOffset 参数。

注解

ReadInt16 启用与非托管 16 位带符号数组的直接交互，无需在读取其元素值之前使用 Marshal.Copy) 将整个非托管数组复制到单独的托管数组 (。

支持从未对齐的内存位置进行读取。

另请参阅

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

适用于

Marshal.ReadInt16 方法

定义

重载

ReadInt16(IntPtr)

参数

返回

例外

示例

注解

另请参阅

适用于

ReadInt16(IntPtr, Int32)

参数

返回

例外

示例

注解

另请参阅

适用于

ReadInt16(Object, Int32)

参数

返回

例外

注解

另请参阅

适用于

其他资源