This documentation is archived and is not being maintained.

UIntPtr.Zero Field

A read-only field that represents a pointer or handle that has been initialized to zero.

The UIntPtr type is not CLS-compliant. The CLS-compliant alternative type is IntPtr. For more information about CLS compliance, see What is the Common Language Specification.

[Visual Basic]
Public Shared ReadOnly Zero As UIntPtr
[C#]
public static readonly UIntPtr Zero;
[C++]
public: static UIntPtr Zero;
[JScript]
public static var Zero : UIntPtr;

Remarks

The value of this field is not equivalent to a null reference (Nothing in Visual Basic). Use this field to efficiently determine whether an instance of UIntPtr has been set to a value other than zero.

For example, assume the variable, uip, is an instance of UIntPtr. You can determine if it has been set by comparing it to the value returned by a constructor, for example: " if uip != new

UIntPtr(0)... ". However, invoking a constructor to get an unintialized pointer is inefficient. It is better to code either " if uip != UIntPtr.Zero... ", or " if

!UIntPtr.Zero.Equals(uip)... ".

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

UIntPtr Structure | UIntPtr Members | System Namespace

Show: