Marshal.ReadInt32 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
관리되지 않는 메모리에서 32비트 부호 있는 정수를 읽습니다. 정렬되지 않은 메모리 위치에서 읽을 수 있습니다.
오버로드
ReadInt32(IntPtr) |
관리되지 않는 메모리에서 32비트 부호 있는 정수를 읽습니다. |
ReadInt32(IntPtr, Int32) |
관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다. |
ReadInt32(Object, Int32) |
사용되지 않음.
관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다. |
ReadInt32(IntPtr)
- Source:
- Marshal.cs
- Source:
- Marshal.cs
- Source:
- Marshal.cs
관리되지 않는 메모리에서 32비트 부호 있는 정수를 읽습니다.
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
nativeint
읽을 관리되지 않는 메모리의 주소입니다.
반환
관리되지 않는 메모리에서 읽은 32비트 부호 있는 정수입니다.
- 특성
예외
예제
다음 예제에서는 및 WriteInt32 메서드를 사용하여 ReadInt32 관리되지 않는 배열을 읽고 쓰는 방법을 보여 줍니다.
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
되지 않는 변수의 값을 읽는 방법을 보여 줍니다.
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입니다. 이 메서드를 사용하면 관리되지 않는 C 스타일 Int32
배열과 직접 상호 작용할 수 있으므로 요소 값을 읽기 전에 관리되지 않는 전체 배열(사용 Marshal.Copy)을 별도의 관리형 배열에 복사하는 데 드는 비용이 제거됩니다.
정렬되지 않은 메모리 위치에서 읽을 수 있습니다.
추가 정보
적용 대상
ReadInt32(IntPtr, Int32)
- Source:
- Marshal.cs
- Source:
- Marshal.cs
- Source:
- Marshal.cs
관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다.
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
nativeint
읽을 관리되지 않는 메모리의 기본 주소입니다.
- ofs
- Int32
읽기 전에 ptr
매개 변수에 추가되는 추가 바이트 오프셋입니다.
반환
관리되지 않는 메모리에서 읽은 32비트 부호 있는 정수입니다.
- 특성
예외
기준 주소(ptr
)에 오프셋 바이트(ofs
)를 더하면 null 또는 잘못된 주소가 생성되는 경우
예제
다음 예제에서는 및 WriteInt32 메서드를 사용하여 ReadInt32 관리되지 않는 배열을 읽고 쓰는 방법을 보여 줍니다.
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
되지 않는 변수의 값을 읽는 방법을 보여 줍니다.
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(Object, Int32)
- Source:
- Marshal.CoreCLR.cs
- Source:
- Marshal.CoreCLR.cs
- Source:
- Marshal.CoreCLR.cs
주의
ReadInt32(Object, Int32) may be unavailable in future releases.
관리되지 않는 메모리의 지정된 오프셋 위치에서 32비트 부호 있는 정수를 읽습니다.
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
소스 개체에 대한 관리되지 않는 메모리의 기본 주소입니다.
- ofs
- Int32
읽기 전에 ptr
매개 변수에 추가되는 추가 바이트 오프셋입니다.
반환
관리되지 않는 메모리의 지정된 오프셋 위치에서 읽은 32비트 부호 있는 정수입니다.
- 특성
예외
기준 주소(ptr
)에 오프셋 바이트(ofs
)를 더하면 null 또는 잘못된 주소가 생성되는 경우
ptr
이 ArrayWithOffset 개체인 경우. 이 메서드에는 ArrayWithOffset 매개 변수를 사용할 수 없습니다.
설명
ReadInt32 를 사용하면 관리되지 않는 32비트 부호 있는 배열과 직접 상호 작용할 수 있으므로 요소 값을 읽기 전에 관리되지 않는 전체 배열(사용 Marshal.Copy)을 별도의 관리형 배열로 복사하는 데 드는 비용이 제거됩니다.
정렬되지 않은 메모리 위치에서 읽을 수 있습니다.
추가 정보
적용 대상
.NET