This documentation is archived and is not being maintained.

BitmapCreateOptions Enumeration

Specifies initialization options for bitmap images.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  System.Windows.Media.Imaging
Assembly:  PresentationCore (in PresentationCore.dll)

type BitmapCreateOptions
<object property="enumerationMemberName" .../>

Member nameDescription
NoneNo BitmapCreateOptions are specified. This is the default value.
PreservePixelFormatEnsures that the PixelFormat a file is stored in is the same as it is loaded to.
DelayCreationCauses a BitmapSource object to delay initialization until it is necessary. This is useful when dealing with collections of images.
IgnoreColorProfileCauses a BitmapSource to ignore an embedded color profile.
IgnoreImageCacheLoads images without using an existing image cache. This option should only be selected when images in a cache need to be refreshed.

If PreservePixelFormat is not selected, the PixelFormat of the image is chosen by the system depending on what the system determines will yield the best performance. Enabling this option preserves the file format but may result in lesser performance.

If BitmapCreateOptions is set to IgnoreColorProfile, calls to methods such as CopyPixels(Array, Int32, Int32) will not return color-corrected bits.

When IgnoreImageCache is selected, any existing entries in the image cache are replaced even if they share the same Uri.

The following code example demonstrates how to instantiate a BitmapImage and specify BitmapCreateOptions.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, 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.