Gets or sets the URI of the image file source displayed by this ImageBrush.
<object ImageSource="string" .../>
value = object.ImageSource
object.ImageSource = value
The image displayed by this ImageBrush.
This property is read/write. The default value is null.
The ImageSource property can be used to reference images in the JPEG and PNG file formats.
The string provided for the ImageSource property is interpreted as a Uniform Resource Identifier (URI). This is in contrast to an Internationalized Resource Identifiers (IRI). This distinction means that characters used to identify an ImageSource that are outside of US-ASCII will need to be encoded.
Relative references are permitted. The starting location for the relative reference is the HTML page that contains the current Silverlight plug-in.
Cross-domain URIs are permitted, 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 JPEG and PNG filename extensions are not required to be in the URI, but if the retrieved file is not determined to be either in JPEG or PNG format, a runtime exception is thrown.
If you are not accessing cross-domain sources, you should consider using SetSource rather than setting ImageSource directly. This provides the advantage of being able to track the download. Also, you can download images as a package and access parts from within the package.
You can specify an initial XAML value of "" (empty string) and then set the value in script at a later time, to create a nonrendering placeholder.
The ImageFailed event can occur if the initial ImageSource attribute value in XAML does not specify a valid source.