ASX Elements Reference
A version of this page is also available for
4/8/2010
Advanced Stream Redirector (ASX) files are based on the Extensible Markup Language (XML) syntax, and are made up of various elements with their associated tags and attributes.
Each element in an ASX file defines a particular setting or action to the Microsoft® Windows Media® Player control.
Some elements must be located in a specific position in the file relative to other elements.
Some elements have required tags and attributes that must be defined in the ASX file. Element names and attributes are not case-sensitive.
The most important part of successfully using ASX files is the correct syntax of the ASX elements. Syntax errors in an ASX file can cause anything from a single attribute being overlooked, to the ASX file not being recognized as valid and failing to work at all.
Almost as important is the order in which the elements appear in the ASX file. The attributes of some elements temporarily override the attributes of similar elements in different sections of the ASX file.
Important
- ASX element and attribute tags are not case sensitive. The text used in the ASX file to define an element can be either upper or lower case, or a mix of both. The opening and closing tags used in an element also can be different case.
- If an element tag does not have any child elements (those that modify or are contained within another element), a single slash character ("/") can be used at the end of the opening tag in place of a closing tag. If the child elements do not appear between the opening and closing tag for an element, they are not child elements for that element and will be ignored or cause an error in the syntax of the ASX file.
For more information about ASX elements, see the following sections, each of which contains a definition of the element, its attributes and their values, and special conditions related to the element.
| Element | Description |
|---|---|
Contains text that represents a description of the associated ASX, or ENTRY element. |
|
Defines a file as an ASX file. |
|
Contains a text string representing the name of the author of an ASX file or media clip. |
|
Defines a URL string appended to the front of URLs sent to the WMP control. |
|
Defines a text string specifying the copyright information for an ASX or ENTRY element. |
|
Defines the length of time the WMP control will render a stream. |
|
Specifies a marker at which the WMP control will stop rendering the stream. |
|
Defines a clip. |
|
Links to the ENTRY elements in an external ASX file. |
|
Defines a behavior or action taken by the WMP control when it receives a script command labeled as an event. |
|
Specifies a URL to a Web site, e-mail address, or script command associated with a show or clip. |
|
Defines an custom parameter associated with a clip. |
|
Specifies a URL for a piece of media content. |
|
Defines the number of times the WMP control repeats one or more ENTRY or ENTRYREF elements. |
|
Specifies a marker from which the WMP control will start rendering the stream. |
|
Defines a text string specifying the title for an ASX or ENTRY element. |