BitmapImage.UriSource Property

Definition

Namespace:

Windows.UI.Xaml.Media.Imaging

Gets or sets the Uniform Resource Identifier (URI) of the graphics source file that generated this BitmapImage.

public:
 property Uri ^ UriSource { Uri ^ get(); void set(Uri ^ value); };

Uri UriSource();

void UriSource(Uri value);

public System.Uri UriSource { get; set; }

var uri = bitmapImage.uriSource;
bitmapImage.uriSource = uri;

Public Property UriSource As Uri

<BitmapImage UriSource="uri" />

Property Value

Uri Uri

An object describing the Uniform Resource Identifier (URI) of the graphics source file that generated this BitmapImage.

Remarks

The BaseUri property might be useful for forming the URI if you're applying an image source file to a particular Image element.

In low memory situations (most likely on lower-memory phones), it is possible for an exception to be raised with the message "The image is unrecognized" and an HRESULT of 0x88982F60. While this exception ordinarily indicates bad data, if your app is close to its memory limit then the cause of the exception is likely to be low memory. In that case, we recommend that you free memory and try again.

Notes for previous versions

Windows 8

Windows 8 had URI validation logic associated with this property's setter. Starting with Windows 8.1 that validation on the property setter is removed. That doesn't mean you get no validation, it means that you get the same final validation you should be using anyway: handling for ImageOpened or ImageFailed events on the Image where the source is applied.

Apps that were compiled for Windows 8 but running on Windows 8.1 use the new Windows 8.1 behavior.

See also

• Image and ImageBrush
• XAML images sample