Export (0) Print
Expand All

WriteableBitmap Constructor (BitmapSource)

Initializes a new instance of the WriteableBitmap class using the provided BitmapSource.

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

[SecuritySafeCriticalAttribute]
public WriteableBitmap(
	BitmapSource source
)

Parameters

source
Type: System.Windows.Media.Imaging.BitmapSource
The BitmapSource to use for initialization.

If source does not use a natively supported bitmap format, format conversions are applied for each frame update, which reduces performance.

If you use a BitmapImage as the source, remember that a BitmapImage constructed by a URL is initialized asynchronously. The default mode in Silverlight is DelayCreation, and in this case the image is possibly not being added to the visual tree and is thus not immediately requested for download. As such the image may be null and throws an exception in the constructor. It may be necessary to construct the image separately (using IgnoreImageCache), attach a handler for ImageOpened for the source, and only construct the WriteableBitmap once the ImageOpened event is handled.

Version Notes

Silverlight for Windows Phone Silverlight for Windows Phone

When you specify a BitmapImage as the parameter for the WriteableBitmap constructor, you must set the CreateOptions property of the BitmapImage before you use it to construct the WriteableBitmap; otherwise, an exception will occur.

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

Show:
© 2014 Microsoft