Marshal.WriteInt64 方法

参考

定义

命名空间:: System.Runtime.InteropServices

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

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

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

将 64 位带符号整数值写入非托管内存。支持写入未对齐的内存位置。

重载

WriteInt64(Object, Int32, Int64)	已过时。按指定偏移量将 64 位带符号整数值写入非托管内存。
WriteInt64(IntPtr, Int64)	将 64 位带符号整数值写入非托管内存。
WriteInt64(IntPtr, Int32, Int64)	按指定偏移量将 64 位带符号整数值写入非托管内存。

WriteInt64(Object, Int32, Int64)

注意

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

按指定偏移量将 64 位带符号整数值写入非托管内存。

public:
 static void WriteInt64(System::Object ^ ptr, int ofs, long val);

[System.Obsolete("WriteInt64(Object, Int32, Int64) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static void WriteInt64 (object ptr, int ofs, long val);

[System.Obsolete("WriteInt64(Object, Int32, Int64) may be unavailable in future releases.")]
public static void WriteInt64 (object ptr, int ofs, long val);

public static void WriteInt64 (object ptr, int ofs, long val);

[System.Security.SecurityCritical]
public static void WriteInt64 (object ptr, int ofs, long val);

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

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

static member WriteInt64 : obj * int * int64 -> unit

[<System.Security.SecurityCritical>]
static member WriteInt64 : obj * int * int64 -> unit

Public Shared Sub WriteInt64 (ptr As Object, ofs As Integer, val As Long)

参数

ptr: Object

非托管内存中目标对象的基址。

ofs: Int32

额外的字节偏移量，在写入前添加到 ptr 参数中。

val: Int64

要写入的值。

属性: ObsoleteAttribute SecurityCriticalAttribute

例外

AccessViolationException

基址 (ptr) 加上偏移字节 (ofs) 可产生空或无效地址。

ArgumentException

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

注解

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

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

另请参阅

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

适用于

WriteInt64(IntPtr, Int64)

将 64 位带符号整数值写入非托管内存。

public:
 static void WriteInt64(IntPtr ptr, long val);

[System.Security.SecurityCritical]
public static void WriteInt64 (IntPtr ptr, long val);

public static void WriteInt64 (IntPtr ptr, long val);

[<System.Security.SecurityCritical>]
static member WriteInt64 : nativeint * int64 -> unit

static member WriteInt64 : nativeint * int64 -> unit

Public Shared Sub WriteInt64 (ptr As IntPtr, val As Long)

参数

ptr: IntPtr
nativeint

非托管内存中要写入的地址。

val: Int64

要写入的值。

属性: SecurityCriticalAttribute

例外

AccessViolationException

ptr 不是识别的格式。

或 -

ptr 上声明的默认值为 null。

或 -

ptr 无效。

示例

下面的示例演示如何使用 ReadInt64 和 WriteInt64 方法读取和写入非托管数组。

static void ReadWriteInt64()
{
    // Allocate unmanaged memory. 
    int elementSize = 8;
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt64(unmanagedArray, i * elementSize, ((Int64)(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.ReadInt64(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteInt64()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 8
    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.WriteInt64(unmanagedArray, i * elementSize, CType(i + 1, Int64))
    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.ReadInt64(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

注解

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

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

另请参阅

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

适用于

WriteInt64(IntPtr, Int32, Int64)

按指定偏移量将 64 位带符号整数值写入非托管内存。

public:
 static void WriteInt64(IntPtr ptr, int ofs, long val);

[System.Security.SecurityCritical]
public static void WriteInt64 (IntPtr ptr, int ofs, long val);

public static void WriteInt64 (IntPtr ptr, int ofs, long val);

[<System.Security.SecurityCritical>]
static member WriteInt64 : nativeint * int * int64 -> unit

static member WriteInt64 : nativeint * int * int64 -> unit

Public Shared Sub WriteInt64 (ptr As IntPtr, ofs As Integer, val As Long)

参数

ptr: IntPtr
nativeint

非托管内存中要写入的基址。

ofs: Int32

额外的字节偏移量，在写入前添加到 ptr 参数中。

val: Int64

要写入的值。

属性: SecurityCriticalAttribute

例外

AccessViolationException

基址 (ptr) 加上偏移字节 (ofs) 可产生空或无效地址。

示例

下面的示例演示如何使用 ReadInt64 和 WriteInt64 方法读取和写入非托管数组。

static void ReadWriteInt64()
{
    // Allocate unmanaged memory. 
    int elementSize = 8;
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt64(unmanagedArray, i * elementSize, ((Int64)(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.ReadInt64(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteInt64()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 8
    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.WriteInt64(unmanagedArray, i * elementSize, CType(i + 1, Int64))
    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.ReadInt64(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

注解

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

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

另请参阅

适用于

Marshal.WriteInt64 方法

定义

重载

WriteInt64(Object, Int32, Int64)

参数

例外

注解

另请参阅

适用于

WriteInt64(IntPtr, Int64)

参数

例外

示例

注解

另请参阅

适用于

WriteInt64(IntPtr, Int32, Int64)

参数

例外

示例

注解

另请参阅

适用于

其他资源