Expand Minimize

MediaElement.Markers property

Applies to Windows and Windows Phone

Gets the collection of timeline markers associated with the currently loaded media file.


Public ReadOnly Property Markers As TimelineMarkerCollection

Property value

Type: TimelineMarkerCollection

The collection of timeline markers (represented as TimelineMarker objects) associated with the currently loaded media file. The default value is an empty collection.


A timeline marker is metadata associated with a particular point in a media file. These markers are usually created ahead of time and stored in the media file itself. They are typically used to name different scenes in a video or provide scripting cues. By handling the MediaElement object's MarkerReached event or by accessing the MediaElement object's Markers property, you can use timeline markers to trigger actions or enable users to seek to selected positions in the media file.


The following example creates a MediaElement object and responds to its MarkerReached event. Each time a timeline marker is reached, the example displays the timeline marker's Time, Type, and Text values.

<MediaElement Name="Media" Source="video.mp4" MarkerReached="Media_MarkerReached" />
<TextBlock Name="txOutput" />

private void Media_MarkerReached(object sender, TimelineMarkerRoutedEventArgs e)
    txOutput.Text =
        string.Format("{0},{1},{2}", e.Marker.Time, e.Marker.Text, e.Marker.Type);


Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]


Windows::UI::Xaml::Controls [C++]



See also




© 2015 Microsoft