Marshal.ReadInt32 메서드

정의

관리되지 않는 메모리에서 32비트 부호 있는 정수를 읽습니다.Reads a 32-bit signed integer from unmanaged memory. 정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

오버로드

ReadInt32(IntPtr)

관리되지 않는 메모리에서 32비트 부호 있는 정수를 읽습니다.Reads a 32-bit signed integer from unmanaged memory.

ReadInt32(IntPtr, Int32)

관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다.Reads a 32-bit signed integer at a given offset from unmanaged memory.

ReadInt32(Object, Int32)
사용되지 않습니다.

관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다.Reads a 32-bit signed integer at a given offset from unmanaged memory.

ReadInt32(IntPtr)

관리되지 않는 메모리에서 32비트 부호 있는 정수를 읽습니다.Reads a 32-bit signed integer from unmanaged memory.

public:
 static int ReadInt32(IntPtr ptr);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr);
public static int ReadInt32 (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint -> int
static member ReadInt32 : nativeint -> int
Public Shared Function ReadInt32 (ptr As IntPtr) As Integer

매개 변수

ptr
IntPtr

읽을 관리되지 않는 메모리의 주소입니다.The address in unmanaged memory from which to read.

반환

Int32

관리되지 않는 메모리에서 읽은 32비트 부호 있는 정수입니다.The 32-bit signed integer read from unmanaged memory.

특성

예외

ptr의 형식을 인식할 수 없는 경우ptr is not a recognized format.

또는-or- ptrnull입니다.ptr is null.

또는-or- ptr이 잘못되었습니다.ptr is invalid.

예제

다음 예제에서는 및 메서드를 사용 하 여 관리 되지 않는 배열을 읽고 쓰는 방법을 보여 줍니다 ReadInt32 WriteInt32 .The following example demonstrates how to read and write to an unmanaged array using the ReadInt32 and WriteInt32 methods.

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

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

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}
Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    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.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    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.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

다음 예제에서는 메서드를 사용 하 여 ReadInt32 관리 되지 않는 변수의 값을 읽는 방법을 보여 줍니다 int .The following example demonstrates how to use the ReadInt32 method to read the value of an unmanaged int variable.

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



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

    // Read the int as a managed Int32.
        Int32 ^ myManagedVal = Marshal::ReadInt32((IntPtr) &myVal);

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

설명

ReadInt32 의 암시적 오프셋이 0 인 경우ReadInt32 has an implied offset of 0. 이 메서드를 사용 하면 관리 되지 않는 C 스타일 배열과 직접 상호 작용 하 Int32 여 해당 요소 값을 읽기 전에 관리 되지 않는 전체 배열 (사용 Marshal.Copy )을 별도의 관리 되는 배열에 복사 하는 비용을 없앨 수 있습니다.This method enables direct interaction with an unmanaged C-style Int32 array, eliminating the expense of copying an entire unmanaged array (using Marshal.Copy) to a separate managed array before reading its element values.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

추가 정보

적용 대상

ReadInt32(IntPtr, Int32)

관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다.Reads a 32-bit signed integer at a given offset from unmanaged memory.

public:
 static int ReadInt32(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (IntPtr ptr, int ofs);
public static int ReadInt32 (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadInt32 : nativeint * int -> int
static member ReadInt32 : nativeint * int -> int
Public Shared Function ReadInt32 (ptr As IntPtr, ofs As Integer) As Integer

매개 변수

ptr
IntPtr

읽을 관리되지 않는 메모리의 기본 주소입니다.The base address in unmanaged memory from which to read.

ofs
Int32

읽기 전에 ptr 매개 변수에 추가되는 추가 바이트 오프셋입니다.An additional byte offset, which is added to the ptr parameter before reading.

반환

Int32

관리되지 않는 메모리에서 읽은 32비트 부호 있는 정수입니다.The 32-bit signed integer read from unmanaged memory.

특성

예외

기준 주소(ptr)에 오프셋 바이트(ofs)를 더하면 null 또는 잘못된 주소가 생성되는 경우Base address (ptr) plus offset byte (ofs) produces a null or invalid address.

예제

다음 예제에서는 및 메서드를 사용 하 여 관리 되지 않는 배열을 읽고 쓰는 방법을 보여 줍니다 ReadInt32 WriteInt32 .The following example demonstrates how to read and write to an unmanaged array using the ReadInt32 and WriteInt32 methods.

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

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

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}
Sub ReadWriteInt32()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 4
    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.WriteInt32(unmanagedArray, i * elementSize, CType(i + 1, Int32))
    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.ReadInt32(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

다음 예제에서는 메서드를 사용 하 여 ReadInt32 관리 되지 않는 변수의 값을 읽는 방법을 보여 줍니다 int .The following example demonstrates how to use the ReadInt32 method to read the value of an unmanaged int variable.

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



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

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

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

설명

ReadInt32 관리 되지 않는 32 비트 부호 있는 배열과의 직접 상호 작용을 사용 하 여 요소 값을 읽기 전에 관리 되지 않는 전체 배열 (사용 Marshal.Copy )을 별도의 관리 되는 배열에 복사 하는 비용을 없앨 수 있습니다.ReadInt32 enables direct interaction with an unmanaged 32-bit signed array, eliminating the expense of copying an entire unmanaged array (using Marshal.Copy) to a separate managed array before reading its element values.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

추가 정보

적용 대상

ReadInt32(Object, Int32)

주의

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

관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다.Reads a 32-bit signed integer at a given offset from unmanaged memory.

public:
 static int ReadInt32(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")]
public static int ReadInt32 (object ptr, int ofs);
public static int ReadInt32 (object ptr, int ofs);
[System.Security.SecurityCritical]
public static int ReadInt32 (object ptr, int ofs);
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
[<System.Obsolete("ReadInt32(Object, Int32) may be unavailable in future releases.")>]
static member ReadInt32 : obj * int -> int
static member ReadInt32 : obj * int -> int
[<System.Security.SecurityCritical>]
static member ReadInt32 : obj * int -> int
Public Shared Function ReadInt32 (ptr As Object, ofs As Integer) As Integer

매개 변수

ptr
Object

소스 개체에 대한 관리되지 않는 메모리의 기본 주소입니다.The base address in unmanaged memory of the source object.

ofs
Int32

읽기 전에 ptr 매개 변수에 추가되는 추가 바이트 오프셋입니다.An additional byte offset, which is added to the ptr parameter before reading.

반환

Int32

관리되지 않는 메모리의 지정된 오프셋 위치에서 읽은 32비트 부호 있는 정수입니다.The 32-bit signed integer read from unmanaged memory at the given offset.

특성

예외

기준 주소(ptr)에 오프셋 바이트(ofs)를 더하면 null 또는 잘못된 주소가 생성되는 경우Base address (ptr) plus offset byte (ofs) produces a null or invalid address.

ptrArrayWithOffset 개체인 경우.ptr is an ArrayWithOffset object. 이 메서드에는 ArrayWithOffset 매개 변수를 사용할 수 없습니다.This method does not accept ArrayWithOffset parameters.

설명

ReadInt32 관리 되지 않는 32 비트 부호 있는 배열과의 직접 상호 작용을 사용 하 여 요소 값을 읽기 전에 관리 되지 않는 전체 배열 (사용 Marshal.Copy )을 별도의 관리 되는 배열에 복사 하는 비용을 없앨 수 있습니다.ReadInt32 enables direct interaction with an unmanaged 32-bit signed array, eliminating the expense of copying an entire unmanaged array (using Marshal.Copy) to a separate managed array before reading its element values.

정렬되지 않은 메모리 위치에서 읽을 수 있습니다.Reading from unaligned memory locations is supported.

추가 정보

적용 대상