BitmapImage.UriSource Property

July 28, 2014

Gets or sets the URI of the graphics source file that generated this BitmapImage.

Namespace:  System.Windows.Media.Imaging
Assembly:  System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.

public Uri UriSource { get; set; }
<BitmapImage UriSource="uri"/>

XAML Values

uri

A URI string. See Remarks; considerations for setting the URI are identical in XAML or code.

Property Value

Type: System.Uri
The URI of the graphics source file that generated this BitmapImage.

Dependency property identifier field: UriSourceProperty

The property is interpreted as a Uniform Resource Identifier (URI). This is in contrast to an Internationalized Resource Identifier (IRI). This distinction means that characters used to identify a file that are outside of US-ASCII will need to be encoded.

Relative references are permitted. The starting location for the relative reference is the installation folder of the application.

The format-specific file name extensions such as .png are not necessarily required to be in the URI, but if the retrieved file is determined not to be a valid image format, a run-time exception is thrown.

Capabilities

If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.

ID_CAP_NETWORKING

Windows Phone 8, Windows Phone OS 7.1

For more info, see App capabilities and hardware requirements for Windows Phone 8.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft