BitmapImage.UriSource BitmapImage.UriSource BitmapImage.UriSource BitmapImage.UriSource Property

Definition

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

public : Uri UriSource { get; set; }
Uri UriSource();

void UriSource(Uri urisource);
public Uri UriSource { get; set; }
Public ReadWrite 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.

Windows 8 behavior

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