NullInstance Field

Summary

An object that represents a null RasterImage.

Syntax

C++/CLI

Java

Python

public static readonly RasterImage NullInstance

public static final RasterImage nullInstance;

public:  
   static RasterImage^ NullInstance

NullInstance (RasterImage)

Field Value

An object that represents a null RasterImage.

Remarks

In some instances, a RasterImage object that is not initialized (is null) is required (for example, when serializing raster images in a system that does not support a true null value). In this case, NullInstance can be used to represent a RasterImage that has not been initialized (but is not null). Use IsNull to test whether a RasterImage object is the null instance.

The NullInstance raster image is a global object and calling any other member besides IsNull will throw an exception. The one exception is calling Dispose which will be ignored.

Note that calling rasterImageObject.IsNull is the equivalent of rasterImageObject == RasterImage.NullInstance.

Requirements

Target Platforms