Marshal.ReadInt64 メソッド

定義

名前空間:: System.Runtime.InteropServices

アセンブリ:: mscorlib.dll, System.Runtime.InteropServices.dll

アセンブリ:: mscorlib.dll

アセンブリ:: System.Runtime.InteropServices.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

アンマネージメモリから 64 ビット符号付き整数を読み取ります。アライメントされていないメモリ位置からの読み取りがサポートされています。

オーバーロード

名前	説明
ReadInt64(IntPtr)	アンマネージメモリから 64 ビット符号付き整数を読み取ります。
ReadInt64(IntPtr, Int32)	アンマネージメモリから、指定されたオフセットで 64 ビット符号付き整数を読み取ります。
ReadInt64(Object, Int32)	古い. アンマネージメモリから、指定されたオフセットで 64 ビット符号付き整数を読み取ります。

ReadInt64(IntPtr)

アンマネージメモリから 64 ビット符号付き整数を読み取ります。

public:
 static long ReadInt64(IntPtr ptr);

[System.Security.SecurityCritical]
public static long ReadInt64(IntPtr ptr);

public static long ReadInt64(IntPtr ptr);

[<System.Security.SecurityCritical>]
static member ReadInt64 : nativeint -> int64

static member ReadInt64 : nativeint -> int64

Public Shared Function ReadInt64 (ptr As IntPtr) As Long

パラメーター

ptr: IntPtr
nativeint

読み取り元のアンマネージメモリ内のアドレス。

返品

Int64

アンマネージメモリから読み取られた 64 ビット符号付き整数。

属性: 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

次の例では、 ReadInt64 メソッドを使用してアンマネージ __int64 変数の値を読み取る方法を示します。

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



void main()
{
    // Create an unmanaged __int64.
    __int64 myVal = 42;

    // Read the value as a managed Int64.
    Int64 ^ myManagedVal = Marshal::ReadInt64((IntPtr) &myVal);

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

注釈

ReadInt64 の暗黙のオフセットは 0 です。このメソッドを使用すると、アンマネージ C スタイルの Int64 配列と直接やり取りできるため、要素値を読み取る前に ( Marshal.Copy を使用して) アンマネージ配列全体を別のマネージド配列にコピーする手間を省きます。

アライメントされていないメモリ位置からの読み取りがサポートされています。

こちらもご覧ください

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

適用対象

ReadInt64(IntPtr, Int32)

アンマネージメモリから、指定されたオフセットで 64 ビット符号付き整数を読み取ります。

public:
 static long ReadInt64(IntPtr ptr, int ofs);

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

public static long ReadInt64(IntPtr ptr, int ofs);

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

static member ReadInt64 : nativeint * int -> int64

Public Shared Function ReadInt64 (ptr As IntPtr, ofs As Integer) As Long

パラメーター

ptr: IntPtr
nativeint

読み取り元のアンマネージメモリ内のベースアドレス。

ofs: Int32

読み取る前に ptr パラメーターに追加されるバイトオフセット。

返品

Int64

指定されたオフセットでアンマネージメモリから読み取られた 64 ビット符号付き整数。

属性: SecurityCriticalAttribute

例外

AccessViolationException

ベースアドレス (ptr) とオフセットバイト (ofs) は、null または無効なアドレスを生成します。

例

次の例では、 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

次の例では、 ReadInt64 メソッドを使用してアンマネージ __int64 変数の値を読み取る方法を示します。


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



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

    // Read value as a managed Int64.
    Int64 ^ myManagedVal = Marshal::ReadInt64((IntPtr) myVal, 0);

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

注釈

ReadInt64 を使用すると、アンマネージ 64 ビット符号付き配列と直接やり取りできるため、要素値を読み取る前に ( Marshal.Copy を使用して) アンマネージ配列全体を別のマネージド配列にコピーする手間を省きます。

アライメントされていないメモリ位置からの読み取りがサポートされています。

こちらもご覧ください

適用対象

ReadInt64(Object, Int32)

注意事項

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

アンマネージメモリから、指定されたオフセットで 64 ビット符号付き整数を読み取ります。

public:
 static long ReadInt64(System::Object ^ ptr, int ofs);

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

public static long ReadInt64(object ptr, int ofs);

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

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

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

static member ReadInt64 : obj * int -> int64

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

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

Public Shared Function ReadInt64 (ptr As Object, ofs As Integer) As Long

パラメーター

ptr: Object

ソースオブジェクトのアンマネージメモリ内のベースアドレス。

ofs: Int32

読み取る前に ptr パラメーターに追加されるバイトオフセット。

返品

Int64

指定されたオフセットでアンマネージメモリから読み取られた 64 ビット符号付き整数。

属性: ObsoleteAttribute SecurityCriticalAttribute

例外

AccessViolationException

ベースアドレス (ptr) とオフセットバイト (ofs) は、null または無効なアドレスを生成します。

ArgumentException

ptr は ArrayWithOffset オブジェクトです。このメソッドは、 ArrayWithOffset パラメーターを受け入れません。

注釈

アライメントされていないメモリ位置からの読み取りがサポートされています。

こちらもご覧ください

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

適用対象

フィードバック

このページはお役に立ちましたか?