Share via

BitmapImage Constructor (Uri)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the BitmapImage class, using the supplied URI.

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

Syntax

'Declaration
Public Sub New ( _
    uriSource As Uri _
)

public BitmapImage(
    Uri uriSource
)

Parameters

  • uriSource
    Type: System.Uri
    The URI that references the source graphics file for the image.

Remarks

The string provided for uriSource 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 name that are outside of US-ASCII will need to be encoded.

Relative references are permitted. The starting ___location for the relative reference is the XAP package that contains the page that created the current object tree.

Cross-___domain URIs are permitted (so long as the server that serves the content permits cross ___domain requests), and specifying the scheme is permitted, but mixing URI schemes (such as accessing an HTTPS image from a Silverlight plug-in hosted on an HTTP-served HTML page) is not permitted.

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

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

Platforms

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