GifBitmapDecoder Constructor (Uri, BitmapCreateOptions, BitmapCacheOption)

 

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

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

[SecurityCriticalAttribute]
public GifBitmapDecoder(
	Uri bitmapUri,
	BitmapCreateOptions createOptions,
	BitmapCacheOption cacheOption
)

Parameters

bitmapUri
Type: System.Uri

Uri that identifies the bitmap to decode.

createOptions
Type: System.Windows.Media.Imaging.BitmapCreateOptions

Initialization options for the bitmap image.

cacheOption
Type: System.Windows.Media.Imaging.BitmapCacheOption

The cache method to use for the bitmap image.

Exception Condition
ArgumentNullException

The bitmapUri value is null.

FileFormatException

The bitmapUri is not a Graphics Interchange Format (GIF) encoded image.

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


// Open a Uri and decode a GIF image
Uri myUri = new Uri("tulipfarm.gif", UriKind.RelativeOrAbsolute);
GifBitmapDecoder decoder2 = new GifBitmapDecoder(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
Show: