Home Library Learn Downloads Support Community
Sign in | United States - English | |
2 out of 7 rated this helpful - Rate this topic

IntPtr Structure

.NET Framework 4

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

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
C#
C++
F#
VB
Copy 
[SerializableAttribute]
[ComVisibleAttribute(true)]
public struct IntPtr : ISerializable

The IntPtr type exposes the following members.

  Name Description
Public method Supported by the XNA Framework Supported by Portable Class Library IntPtr(Int32) Initializes a new instance of IntPtr using the specified 32-bit pointer or handle.
Public method Supported by the XNA Framework Supported by Portable Class Library IntPtr(Int64) Initializes a new instance of IntPtr using the specified 64-bit pointer.
Public method Supported by the XNA Framework IntPtr(Void*) Initializes a new instance of IntPtr using the specified pointer to an unspecified type.
Top
  Name Description
Public property Static member Supported by the XNA Framework Supported by Portable Class Library Size Gets the size of this instance.
Top
  Name Description
Public method Static member Add Adds an offset to the value of a pointer.
Public method Supported by the XNA Framework Supported by Portable Class Library Equals Returns a value indicating whether this instance is equal to a specified object. (Overrides ValueType.Equals(Object).)
Protected method Supported by the XNA Framework Supported by Portable Class Library Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method Supported by the XNA Framework Supported by Portable Class Library GetHashCode Returns the hash code for this instance. (Overrides ValueType.GetHashCode().)
Public method Supported by the XNA Framework Supported by Portable Class Library GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method Supported by the XNA Framework Supported by Portable Class Library MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method Static member Subtract Subtracts an offset from the value of a pointer.
Public method Supported by the XNA Framework Supported by Portable Class Library ToInt32 Converts the value of this instance to a 32-bit signed integer.
Public method Supported by the XNA Framework Supported by Portable Class Library ToInt64 Converts the value of this instance to a 64-bit signed integer.
Public method Supported by the XNA Framework ToPointer Converts the value of this instance to a pointer to an unspecified type.
Public method Supported by the XNA Framework Supported by Portable Class Library ToString() Converts the numeric value of the current IntPtr object to its equivalent string representation. (Overrides ValueType.ToString().)
Public method ToString(String) Converts the numeric value of the current IntPtr object to its equivalent string representation.
Top
  Name Description
Public operator Static member Addition Adds an offset to the value of a pointer.
Public operator Static member Supported by the XNA Framework Supported by Portable Class Library Equality Determines whether two specified instances of IntPtr are equal.
Public operator Static member Supported by the XNA Framework Supported by Portable Class Library Explicit(Int32 to IntPtr) Converts the value of a 32-bit signed integer to an IntPtr.
Public operator Static member Supported by the XNA Framework Supported by Portable Class Library Explicit(Int64 to IntPtr) Converts the value of a 64-bit signed integer to an IntPtr.
Public operator Static member Supported by the XNA Framework Explicit(IntPtr to Void*) Converts the value of the specified IntPtr to a pointer to an unspecified type.
Public operator Static member Supported by the XNA Framework Supported by Portable Class Library Explicit(IntPtr to Int64) Converts the value of the specified IntPtr to a 64-bit signed integer.
Public operator Static member Supported by the XNA Framework Supported by Portable Class Library Explicit(IntPtr to Int32) Converts the value of the specified IntPtr to a 32-bit signed integer.
Public operator Static member Supported by the XNA Framework Explicit(Void* to IntPtr) Converts the specified pointer to an unspecified type to an IntPtr.
Public operator Static member Supported by the XNA Framework Supported by Portable Class Library Inequality Determines whether two specified instances of IntPtr are not equal.
Public operator Static member Subtraction Subtracts an offset from the value of a pointer.
Top
  Name Description
Public field Static member Supported by the XNA Framework Supported by Portable Class Library Zero A read-only field that represents a pointer or handle that has been initialized to zero.
Top
  Name Description
Explicit interface implemetation Private method ISerializable.GetObjectData Populates a SerializationInfo object with the data needed to serialize the current IntPtr object.
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.

This type implements the ISerializable interface.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

This type is thread safe.

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ