Share via


ImageFailed Event (ImageBrush)

Occurs when there is a media related error.

XAML
<object ImageFailed="eventhandlerFunction" .../>
Scripting
[token = ]object.AddEventListener("ImageFailed", eventhandlerFunction)

AddEventListener Parameters

token

integer

A token that is returned from the function, which you can optionally retain as a variable. If you intend to call RemoveEventListener to remove the handler, you will need this token.

eventhandlerFunction

object

The name of your event handler function as it is defined in script. When used as an AddEventListener parameter, quotes around the function name are not required. See Remarks.

Event Handler Parameters

sender

object

Identifies the object that invoked the event.

eventArgs

object

This parameter is always set to null.

Remarks

Conditions in which this event can occur include:

  • File not found.
  • Invalid file format - unrecognized or unsupported format.
  • Unknown file format decoding error after upload.

The event can occur if the initial ImageSource attribute value in XAML does not specify a valid source, or can occur if the ImageSource value of an existing image is subsequently set to an invalid source in JavaScript.

You can also add handlers in script using a quoted string for the event handler name:

object.AddEventListener("ImageFailed", "eventhandlerFunction")

This syntax also returns a token; however, the token is not an absolute requirement for removing the handler, in cases where the handler was added by using a quoted string. For details, see RemoveEventListener.

Applies To

ImageBrush

See Also

Error Handling
Error Tables
Silverlight Events
Source
ImageFailed (ImageBrush)