Partager via


MediaFailed

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

Occurs when there is an error associated with the media Source.

<object MediaFailed="eventhandlerFunction"  .../>
[token = ]object.AddEventListener("MediaFailed", eventhandlerFunction)

Arguments

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, quotation marks around the function name are not required. (See the "Remarks" section.)

Event Handler Parameters

sender

object

The object that invoked the event.

eventArgs

object

This parameter is always set to null.

Managed Equivalent

MediaFailed

Remarks

The MediaFailed event can occur in the following conditions:

  • File not found.

  • Invalid (unrecognized or unsupported) media format.

  • Unknown media error during playback.

Setting a cross-domain URI for Source will either succeed, or will not return a valid status for any failure. In this case, an error is thrown on the SetValue method call for setting Source.

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

object.AddEventListener("MediaFailed", "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

MediaElement