다음을 통해 공유


Marshal.ReadInt64 메서드

정의

관리되지 않는 메모리에서 64비트 부호 있는 정수를 읽습니다. 정렬되지 않은 메모리 위치에서 읽을 수 있습니다.

오버로드

ReadInt64(IntPtr)

관리되지 않는 메모리에서 64비트 부호 있는 정수를 읽습니다.

ReadInt64(IntPtr, Int32)

관리되지 않는 메모리의 지정된 오프셋 위치에서 64비트 부호 있는 정수를 읽습니다.

ReadInt64(Object, Int32)
사용되지 않음.

관리되지 않는 메모리의 지정된 오프셋 위치에서 64비트 부호 있는 정수를 읽습니다.

ReadInt64(IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

관리되지 않는 메모리에서 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

읽을 관리되지 않는 메모리의 주소입니다.

반환

관리되지 않는 메모리에서 읽은 64비트 부호 있는 정수입니다.

특성

예외

ptr의 형식을 인식할 수 없는 경우

또는

ptrnull입니다.

또는

ptr이 잘못되었습니다.

예제

다음 예제에서는 및 WriteInt64 메서드를 사용하여 ReadInt64 관리되지 않는 배열을 읽고 쓰는 방법을 보여 줍니다.

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)을 별도의 관리형 배열에 복사하는 데 드는 비용이 제거됩니다.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.

추가 정보

적용 대상

ReadInt64(IntPtr, Int32)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

관리되지 않는 메모리의 지정된 오프셋 위치에서 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 매개 변수에 추가되는 추가 바이트 오프셋입니다.

반환

관리되지 않는 메모리의 지정된 오프셋 위치에서 읽은 64비트 부호 있는 정수입니다.

특성

예외

기준 주소(ptr)에 오프셋 바이트(ofs)를 더하면 null 또는 잘못된 주소가 생성되는 경우

예제

다음 예제에서는 및 WriteInt64 메서드를 사용하여 ReadInt64 관리되지 않는 배열을 읽고 쓰는 방법을 보여 줍니다.

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)

Source:
Marshal.CoreCLR.cs
Source:
Marshal.CoreCLR.cs
Source:
Marshal.CoreCLR.cs

주의

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);
[System.Obsolete("ReadInt64(Object, Int32) may be unavailable in future releases.")]
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.")>]
[<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
static member ReadInt64 : obj * int -> int64
[<System.Security.SecurityCritical>]
static member ReadInt64 : obj * int -> int64
Public Shared Function ReadInt64 (ptr As Object, ofs As Integer) As Long

매개 변수

ptr
Object

소스 개체에 대한 관리되지 않는 메모리의 기본 주소입니다.

ofs
Int32

읽기 전에 ptr 매개 변수에 추가되는 추가 바이트 오프셋입니다.

반환

관리되지 않는 메모리의 지정된 오프셋 위치에서 읽은 64비트 부호 있는 정수입니다.

특성

예외

기준 주소(ptr)에 오프셋 바이트(ofs)를 더하면 null 또는 잘못된 주소가 생성되는 경우

ptrArrayWithOffset 개체인 경우. 이 메서드에는 ArrayWithOffset 매개 변수를 사용할 수 없습니다.

설명

ReadInt64 를 사용하면 관리되지 않는 64비트 부호 있는 배열과 직접 상호 작용할 수 있으므로 요소 값을 읽기 전에 관리되지 않는 전체 배열(사용 Marshal.Copy)을 별도의 관리형 배열로 복사하는 데 드는 비용이 제거됩니다.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.

추가 정보

적용 대상