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)

Source:

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)

Source:

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)

Source:

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) 可产生空或无效地址。

示例

以下示例演示如何使用 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)

Source:

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) 可产生空或无效地址。

示例

以下示例演示如何使用 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)

Source:

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) 可产生空或无效地址。

ArgumentException

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

注解

WriteInt16 允许与非托管 16 位带符号数组直接交互，从而消除了在设置其元素值之前使用 Marshal.Copy) 将整个非托管数组 (复制到单独的托管数组的开销。

支持写入未对齐的内存位置。

另请参阅

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

WriteInt16(Object, Int32, Int16)

Source:

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) 可产生空或无效地址。

ArgumentException

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

注解

WriteInt16 允许与非托管 16 位带符号数组直接交互，从而消除了在设置其元素值之前使用 Marshal.Copy) 将整个非托管数组 (复制到单独的托管数组的开销。

支持写入未对齐的内存位置。

另请参阅

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