This topic has not yet been rated - Rate this topic

IntPtr Structure

April 12, 2014

A platform-specific type that is used to represent a pointer or a handle.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
public struct IntPtr

The IntPtr type exposes the following members.

  NameDescription
Public methodIntPtr(Int32)Initializes a new instance of IntPtr using the specified 32-bit pointer or handle.
Public methodIntPtr(Int64)Initializes a new instance of IntPtr using the specified 64-bit pointer.
Public methodIntPtr(Void*)Security Critical. Initializes a new instance of IntPtr using the specified pointer to an unspecified type.
Top
  NameDescription
Public propertyStatic memberSizeGets the size of this instance.
Top
  NameDescription
Public methodStatic memberAddAdds an offset to the value of a pointer.
Public methodEqualsReturns a value indicating whether this instance is equal to a specified object. (Overrides ValueType.Equals(Object).)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeReturns the hash code for this instance. (Overrides ValueType.GetHashCode().)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodStatic memberSubtractSubtracts an offset from the value of a pointer.
Public methodToInt32Converts the value of this instance to a 32-bit signed integer.
Public methodToInt64Converts the value of this instance to a 64-bit signed integer.
Public methodToPointerConverts the value of this instance to a pointer to an unspecified type.
Public methodToString()Converts the numeric value of the current IntPtr object to its equivalent string representation. (Overrides ValueType.ToString().)
Public methodToString(String)Converts the numeric value of the current IntPtr object to its equivalent string representation.
Top
  NameDescription
Public operatorStatic memberAdditionAdds an offset to the value of a pointer.
Public operatorStatic memberEqualityDetermines whether two specified instances of IntPtr are equal.
Public operatorStatic memberExplicit(Int32 to IntPtr)Converts the value of a 32-bit signed integer to an IntPtr.
Public operatorStatic memberExplicit(Int64 to IntPtr)Converts the value of a 64-bit signed integer to an IntPtr.
Public operatorStatic memberExplicit(IntPtr to Int64)Converts the value of the specified IntPtr to a 64-bit signed integer.
Public operatorStatic memberExplicit(IntPtr to Void*)Converts the value of the specified IntPtr to a pointer to an unspecified type.
Public operatorStatic memberExplicit(IntPtr to Int32)Converts the value of the specified IntPtr to a 32-bit signed integer.
Public operatorStatic memberExplicit(Void* to IntPtr)Security Critical. Converts the specified pointer to an unspecified type to an IntPtr.
Public operatorStatic memberInequalityDetermines whether two specified instances of IntPtr are not equal.
Public operatorStatic memberSubtractionSubtracts an offset from the value of a pointer.
Top
  NameDescription
Public fieldStatic memberZeroA read-only field that represents a pointer or handle that has been initialized to zero.
Top

The IntPtr type is designed to be an integer whose size is platform-specific. 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.

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 objects can also be used to hold handles. For example, instances of IntPtr are used extensively in the System.IO.FileStream class to hold file handles.

The IntPtr type is CLS-compliant, while the UIntPtr type is not. Only the IntPtr type is used in the common language runtime. The UIntPtr type is provided mostly to maintain architectural symmetry with the IntPtr type.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

This type is thread safe.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.