BmpBitmapDecoder Constructor (Uri, BitmapCreateOptions, BitmapCacheOption)


Initializes a new instance of BmpBitmapDecoder from the specified Uri with the specified createOptions and cacheOption.

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

public BmpBitmapDecoder(
	Uri bitmapUri,
	BitmapCreateOptions createOptions,
	BitmapCacheOption cacheOption


Type: System.Uri

Uri that identifies the bitmap to decode.

Type: System.Windows.Media.Imaging.BitmapCreateOptions

Initialization options for the bitmap image.

Type: System.Windows.Media.Imaging.BitmapCacheOption

The cache method to use for the bitmap image.

Exception Condition

The bitmapUri value is null.


The bitmapUri is not a bitmap (BMP) encoded image.

The following code example demonstrates how to create an instance of and use a BmpBitmapDecoder from a Uri. The decoded image is used as the source of an Image control.

// Open a Uri and decode a BMP image
Uri myUri = new Uri("tulipfarm.bmp", UriKind.RelativeOrAbsolute);
BmpBitmapDecoder decoder2 = new BmpBitmapDecoder(myUri, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource2 = decoder2.Frames[0];

// Draw the Image
Image myImage2 = new Image();
myImage2.Source = bitmapSource2;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);

.NET Framework
Available since 3.0
Return to top