WriteableBitmap Constructor (BitmapSource)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

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

Syntax

Public Sub New ( _
    source As BitmapSource _
)
public WriteableBitmap(
    BitmapSource source
)

Parameters

Remarks

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 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 Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

WriteableBitmap Class

WriteableBitmap Overload

System.Windows.Media.Imaging Namespace