IntPtr IntPtr IntPtr IntPtr Struct

정의

포인터나 핸들을 나타내는 데 사용되는 플랫폼별 형식입니다. A platform-specific type that is used to represent a pointer or a handle.

public value class IntPtr : System::Runtime::Serialization::ISerializable
[System.Runtime.InteropServices.ComVisible(true)]
[Serializable]
public struct IntPtr : System.Runtime.Serialization.ISerializable
type nativeint = struct
    interface ISerializable
Public Structure IntPtr
Implements ISerializable
상속
특성
ComVisibleAttribute SerializableAttribute
구현

예제

다음 예제에서는 배열에 있는 문자를 반대로 하려면 관리 되는 포인터를 사용 합니다.The following example uses managed pointers to reverse the characters in an array. 초기화는 String 개체 및 해당 길이 가져옵니다 같은 작업을 수행 합니다.After it initializes a String object and gets its length, it does the following:

  1. 호출 된 Marshal.StringToHGlobalAnsi ANSI (싱글바이트) 문자로 관리 되지 않는 메모리에 유니코드 문자열을 복사 하는 방법입니다.Calls the Marshal.StringToHGlobalAnsi method to copy the Unicode string to unmanaged memory as an ANSI (one-byte) character. 메서드는 IntPtr 관리 되지 않는 문자열의 시작 부분을 가리키는 개체입니다.The method returns an IntPtr object that points to the beginning of the unmanaged string. Visual Basic 예제에서는이 포인터를 직접 사용 c + + 및 C# 예제에서는 바이트에 대 한 포인터로 캐스팅 됩니다.The Visual Basic example uses this pointer directly; in the C++ and C# examples, it is cast to a pointer to a byte.

  2. 호출 된 Marshal.AllocHGlobal 관리 되지 않는 문자열을 차지 하는 대로 동일한 수의 바이트를 할당 하는 방법입니다.Calls the Marshal.AllocHGlobal method to allocate the same number of bytes as the unmanaged string occupies. 메서드는 IntPtr 관리 되지 않는 메모리 블록의 시작 부분을 가리키는 개체입니다.The method returns an IntPtr object that points to the beginning of the unmanaged block of memory. Visual Basic 예제에서는이 포인터를 직접 사용 c + + 및 C# 예제에서는 바이트에 대 한 포인터로 캐스팅 됩니다.The Visual Basic example uses this pointer directly; in the C++ and C# examples, it is cast to a pointer to a byte.

  3. 라는 변수를 정의 하는 Visual Basic 예제에서는 offset ANSI 문자열의 길이입니다.The Visual Basic example defines a variable named offset that is equal to the length of the ANSI string. ANSI 문자열의 다음 헌장 복사 되는 관리 되지 않는 메모리로 오프셋을 결정 하는 것이 됩니다.It is used to determine the offset into unmanaged memory to which the next charter in the ANSI string is copied. 시작 값 문자열의 길이 이므로 복사 작업은 메모리 블록의 끝에 문자를 문자열의 시작 부분에서 복사 합니다.Because its starting value is the length of the string, the copy operation will copy a character from the start of the string to the end of the memory block.

    C# 및 c + + 예제 호출을 ToPointer 문자열 및 관리 되지 않는 메모리 블록의 시작 주소에 대 한 관리 되지 않는 포인터를 가져오기 위한 메서드를 추가 하는 하나 및 ANSI 문자열의 시작 주소에 대 한 문자열의 길이 보다 작은 합니다.The C# and C++ examples call the ToPointer method to get an unmanaged pointer to the starting address of the string and the unmanaged block of memory, and they add one less than the length of the string to the starting address of the ANSI string. 관리 되지 않는 문자열 포인터를 이제를 가리키므로 문자열의 끝, 복사 작업은 메모리 블록의 시작 문자를 문자열의 끝에서 복사 합니다.Because the unmanaged string pointer now points to the end of the string, the copy operation will copy a character from the end of the string to the start of the memory block.

  4. Loop를 사용 하 여 각 문자 문자열에서 관리 되지 않는 메모리 블록에 복사 합니다.Uses a loop to copy each character from the string to the unmanaged block of memory.

    Visual Basic 예제에서는 호출 된 Marshal.ReadByte(IntPtr, Int32) ANSI 문자열에 관리 되는 포인터에서 지정 된 오프셋 바이트 (또는 1 바이트 문자)를 읽는 방법.The Visual Basic example calls the Marshal.ReadByte(IntPtr, Int32) method to read the byte (or one-byte character) at a specified offset from the managed pointer to the ANSI string. 오프셋은 루프가 반복 될 때마다 증가 합니다.The offset is incremented with each iteration of the loop. 그런 다음 호출 하는 Marshal.WriteByte(IntPtr, Int32, Byte) 메모리 주소로 바이트를 쓸 메서드가 관리 되지 않는 메모리 블록에 더하기의 시작 주소로 정의 offset합니다.It then calls the Marshal.WriteByte(IntPtr, Int32, Byte) method to write the byte to the memory address defined by the starting address of the unmanaged block of memory plus offset. 그런 다음 감소 offset합니다.It then decrements offset.

    C# 및 c + + 예제에 복사 작업을 수행할 한 관리 되지 않는 ANSI 문자열에서 다음 위치의 주소에 대 한 포인터를 감소 하 고 관리 되지 않는 블록에 다음 주소에 대 한 포인터를 증가 키를 누릅니다.The C# and C++ examples perform the copy operation, then decrement the pointer to the address of the next location in the unmanaged ANSI string and increment the pointer to the next address in the unmanaged block.

  5. 모든 예제를 호출 합니다 Marshal.PtrToStringAnsi 관리 되는 유니코드 복사 ANSI 문자열을 포함 하는 관리 되지 않는 메모리 블록을 변환할 String 개체입니다.All examples call the Marshal.PtrToStringAnsi to convert the unmanaged memory block containing the copied ANSI string to a managed Unicode String object.

  6. 원래 및 역방향 문자열을 표시 한 후 모든 예제는 다음과 같이 호출 됩니다.는 FreeHGlobal 관리 되지 않는 ANSI 문자열 및 관리 되지 않는 메모리 블록에 할당 된 메모리를 확보 하는 방법입니다.After displaying the original and reversed strings, all examples call the FreeHGlobal method to free the memory allocated for the unmanaged ANSI string and the unmanaged block of memory.

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

class NotTooSafeStringReverse
{
public:
    static void Main()
    {
        String^ stringA = "I seem to be turned around!";
        int copylen = stringA->Length;

        // Allocate HGlobal memory for source and destination strings
        IntPtr sptr = Marshal::StringToHGlobalAnsi(stringA);
        IntPtr dptr = Marshal::AllocHGlobal(copylen + 1);

        char *src = (char *)sptr.ToPointer();
        char *dst = (char *)dptr.ToPointer();

        if (copylen > 0)
        {
            // set the source pointer to the end of the string
            // to do a reverse copy.
            src += copylen - 1;

            while (copylen-- > 0)
            {
                *dst++ = *src--;
            }
            *dst = 0;
        }
        String^ stringB = Marshal::PtrToStringAnsi(dptr);

        Console::WriteLine("Original:\n{0}\n", stringA);
        Console::WriteLine("Reversed:\n{0}", stringB);

        // Free HGlobal memory
        Marshal::FreeHGlobal(dptr);
        Marshal::FreeHGlobal(sptr);
    }
};

int main()
{
    NotTooSafeStringReverse::Main();
}

// The progam has the following output:
//
// Original:
// I seem to be turned around!
//
// Reversed:
// !dnuora denrut eb ot mees I
using System;
using System.Runtime.InteropServices;

class NotTooSafeStringReverse
{
    static public void Main()
    {
        string stringA = "I seem to be turned around!";
        int copylen = stringA.Length;

        // Allocate HGlobal memory for source and destination strings
        IntPtr sptr = Marshal.StringToHGlobalAnsi(stringA);
        IntPtr dptr = Marshal.AllocHGlobal(copylen + 1);

        // The unsafe section where byte pointers are used.
        unsafe
        {
            byte *src = (byte *)sptr.ToPointer();
            byte *dst = (byte *)dptr.ToPointer();

            if (copylen > 0)
            {
                // set the source pointer to the end of the string
                // to do a reverse copy.
                src += copylen - 1;

                while (copylen-- > 0)
                {
                    *dst++ = *src--;
                }
                *dst = 0;
            }
        }
        string stringB = Marshal.PtrToStringAnsi(dptr);

        Console.WriteLine("Original:\n{0}\n", stringA);
        Console.WriteLine("Reversed:\n{0}", stringB);

        // Free HGlobal memory
        Marshal.FreeHGlobal(dptr);
        Marshal.FreeHGlobal(sptr);
    }
}

// The progam has the following output:
//
// Original:
// I seem to be turned around!
//
// Reversed:
// !dnuora denrut eb ot mees I
Imports System
Imports System.Runtime.InteropServices

Public Module Example
    Public Sub Main()
        Dim stringA As String = "I seem to be turned around!"
        Dim copylen As Integer = stringA.Length

        ' Allocate HGlobal memory for source and destination strings
        Dim sptr As IntPtr = Marshal.StringToHGlobalAnsi(stringA)
        Dim dptr As IntPtr = Marshal.AllocHGlobal(copylen)
        Dim offset As Integer = copylen - 1

         For ctr As Integer = 0 To copylen - 1
            Dim b As Byte = Marshal.ReadByte(sptr, ctr)
            Marshal.WriteByte(dptr, offset, b)
            offset -= 1
         Next

        Dim stringB As String = Marshal.PtrToStringAnsi(dptr)

        Console.WriteLine("Original:{1}{0}{1}", stringA, vbCrLf)
        Console.WriteLine("Reversed:{1}{0}{1}", stringB, vbCrLf)

        ' Free HGlobal memory
        Marshal.FreeHGlobal(dptr)
        Marshal.FreeHGlobal(sptr)
    End Sub
End Module
' The example displays the following output:
'       Original:
'       I seem to be turned around!
'
'       Reversed:
'       !dnuora denrut eb ot mees I

설명

IntPtr 플랫폼별 크기가 정수 여야 형식은 디자인 되었습니다.The IntPtr type is designed to be an integer whose size is platform-specific. 즉,이 형식의 인스턴스는 32 비트 하드웨어 및 운영 체제에서 32 비트 및 64 비트 하드웨어 및 운영 체제에 64 비트 수 해야 합니다.That is, an instance of this type is expected to be 32-bits on 32-bit hardware and operating systems, and 64-bits on 64-bit hardware and operating systems.

IntPtr 형식 포인터를 지원 하지 않는 언어 간에 데이터를 참조 하는 일반적인 수단으로 포인터를 지 원하는 언어에서 사용할 수 있습니다.The IntPtr type can be used by languages that support pointers, and as a common means of referring to data between languages that do and do not support pointers.

IntPtr 핸들을 보유할 개체를 사용할 수도 있습니다.IntPtr objects can also be used to hold handles. 예를 들어 인스턴스 IntPtr 에서 광범위 하 게 되는 System.IO.FileStream 파일 핸들을 보유 하는 클래스입니다.For example, instances of IntPtr are used extensively in the System.IO.FileStream class to hold file handles.

합니다 IntPtr 형식이 CLS 규격이 동안는 UIntPtr 형식이 아닙니다.The IntPtr type is CLS-compliant, while the UIntPtr type is not. IntPtr 형식은 공용 언어 런타임에서 사용 됩니다.Only the IntPtr type is used in the common language runtime. 합니다 UIntPtr 구조적 대칭을 유지 하기 위해 주로 형식이 제공는 IntPtr 형식입니다.The UIntPtr type is provided mostly to maintain architectural symmetry with the IntPtr type.

이 형식이 구현 하는 ISerializable 인터페이스입니다.This type implements the ISerializable interface.

생성자

IntPtr(Int32) IntPtr(Int32) IntPtr(Int32) IntPtr(Int32)

지정된 64비트 포인터나 핸들을 사용하여 IntPtr의 새 인스턴스를 초기화합니다. Initializes a new instance of IntPtr using the specified 32-bit pointer or handle.

IntPtr(Int64) IntPtr(Int64) IntPtr(Int64) IntPtr(Int64)

지정된 64비트 포인터를 사용하여 IntPtr의 새 인스턴스를 초기화합니다. Initializes a new instance of IntPtr using the specified 64-bit pointer.

IntPtr(Void*) IntPtr(Void*) IntPtr(Void*) IntPtr(Void*)

알 수 없는 형식의 지정된 포인터를 사용하여 IntPtr의 새 인스턴스를 초기화합니다. Initializes a new instance of IntPtr using the specified pointer to an unspecified type.

필드

Zero Zero Zero Zero

0으로 초기화된 포인터나 핸들을 나타내는 읽기 전용 필드입니다. A read-only field that represents a pointer or handle that has been initialized to zero.

속성

Size Size Size Size

이 인스턴스의 크기를 가져옵니다. Gets the size of this instance.

메서드

Add(IntPtr, Int32) Add(IntPtr, Int32) Add(IntPtr, Int32) Add(IntPtr, Int32)

포인터의 값에 오프셋을 더합니다. Adds an offset to the value of a pointer.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다. Returns a value indicating whether this instance is equal to a specified object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

이 인스턴스의 해시 코드를 반환합니다. Returns the hash code for this instance.

Subtract(IntPtr, Int32) Subtract(IntPtr, Int32) Subtract(IntPtr, Int32) Subtract(IntPtr, Int32)

포인터의 값에서 오프셋을 뺍니다. Subtracts an offset from the value of a pointer.

ToInt32() ToInt32() ToInt32() ToInt32()

이 인스턴스의 값을 32비트의 부호 있는 정수로 변환합니다. Converts the value of this instance to a 32-bit signed integer.

ToInt64() ToInt64() ToInt64() ToInt64()

이 인스턴스의 값을 64비트의 부호 있는 정수로 변환합니다. Converts the value of this instance to a 64-bit signed integer.

ToPointer() ToPointer() ToPointer() ToPointer()

이 인스턴스의 값을 알 수 없는 형식의 포인터로 변환합니다. Converts the value of this instance to a pointer to an unspecified type.

ToString(String) ToString(String) ToString(String) ToString(String)

현재 IntPtr 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다. Converts the numeric value of the current IntPtr object to its equivalent string representation.

ToString() ToString() ToString() ToString()

현재 IntPtr 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다. Converts the numeric value of the current IntPtr object to its equivalent string representation.

연산자

Addition(IntPtr, Int32) Addition(IntPtr, Int32) Addition(IntPtr, Int32) Addition(IntPtr, Int32)

포인터의 값에 오프셋을 더합니다. Adds an offset to the value of a pointer.

Equality(IntPtr, IntPtr) Equality(IntPtr, IntPtr) Equality(IntPtr, IntPtr) Equality(IntPtr, IntPtr)

IntPtr의 지정된 두 인스턴스가 같은지를 확인합니다. Determines whether two specified instances of IntPtr are equal.

Explicit(Void* to IntPtr) Explicit(Void* to IntPtr) Explicit(Void* to IntPtr) Explicit(Void* to IntPtr)

알 수 없는 형식의 지정된 포인터를 IntPtr로 변환합니다. Converts the specified pointer to an unspecified type to an IntPtr. 이 API는 CLS 규격이 아닙니다. This API is not CLS-compliant.

Explicit(IntPtr to Int64) Explicit(IntPtr to Int64) Explicit(IntPtr to Int64) Explicit(IntPtr to Int64)

지정된 IntPtr의 값을 64비트의 부호 있는 정수로 변환합니다. Converts the value of the specified IntPtr to a 64-bit signed integer.

Explicit(IntPtr to Void*) Explicit(IntPtr to Void*) Explicit(IntPtr to Void*) Explicit(IntPtr to Void*)

지정된 IntPtr의 값을 알 수 없는 형식의 포인터로 변환합니다. Converts the value of the specified IntPtr to a pointer to an unspecified type. 이 API는 CLS 규격이 아닙니다. This API is not CLS-compliant.

Explicit(Int64 to IntPtr) Explicit(Int64 to IntPtr) Explicit(Int64 to IntPtr) Explicit(Int64 to IntPtr)

64비트의 부호 있는 정수의 값을 IntPtr로 변환합니다. Converts the value of a 64-bit signed integer to an IntPtr.

Explicit(Int32 to IntPtr) Explicit(Int32 to IntPtr) Explicit(Int32 to IntPtr) Explicit(Int32 to IntPtr)

32비트의 부호 있는 정수의 값을 IntPtr로 변환합니다. Converts the value of a 32-bit signed integer to an IntPtr.

Explicit(IntPtr to Int32) Explicit(IntPtr to Int32) Explicit(IntPtr to Int32) Explicit(IntPtr to Int32)

지정된 IntPtr의 값을 32비트의 부호 있는 정수로 변환합니다. Converts the value of the specified IntPtr to a 32-bit signed integer.

Inequality(IntPtr, IntPtr) Inequality(IntPtr, IntPtr) Inequality(IntPtr, IntPtr) Inequality(IntPtr, IntPtr)

IntPtr의 지정된 두 인스턴스가 다른지를 확인합니다. Determines whether two specified instances of IntPtr are not equal.

Subtraction(IntPtr, Int32) Subtraction(IntPtr, Int32) Subtraction(IntPtr, Int32) Subtraction(IntPtr, Int32)

포인터의 값에서 오프셋을 뺍니다. Subtracts an offset from the value of a pointer.

명시적 인터페이스 구현

IEquatable<IntPtr>.Equals(IntPtr) IEquatable<IntPtr>.Equals(IntPtr) IEquatable<IntPtr>.Equals(IntPtr) IEquatable<IntPtr>.Equals(IntPtr)
ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

현재 SerializationInfo 개체를 serialize하는 데 필요한 데이터로 IntPtr 개체를 채웁니다. Populates a SerializationInfo object with the data needed to serialize the current IntPtr object.

적용 대상

스레드 보안

이 형식은 스레드로부터 안전합니다. This type is thread safe.

추가 정보