In order to access this site you need to enable JavaScript!

You are here: Reference > JavaScript > client-side > ActiveX > ADO > methods > namedRecordset (applet, object, xml)

namedRecordset method (applet, object, xml)

Browser support:

Returns a recordset object that represents the records of the specified data member from a data source object.

Syntax:

object.namedRecordset (recordName [, subChapter]);

You can find the related objects in the Supported by objects section below.

Parameters:

recordName

Required. String that specifies the name of the data member. Use an empty string to get the default data member (such as the recordset property).

subChapter

Optional. String that specifies a hierarchical path to a sub-dataset.

Return value:

Returns a recordset object or null.

Example HTML code 1:

This example illustrates the use of the namedRecordset method:

Code

news.xml

<head>
    <script type="text/javascript">
        function OnNewsComplete () {
            var boundingObj = event.srcElement;

            var items = boundingObj.namedRecordset ("", "item");
            items.MoveFirst ();

            while (!items.EOF) {
                var title = items.Fields ("title").value;
                var link = items.Fields ("link").value;
                DisplayItem (title, link);
                items.MoveNext ();
            }
        }

        function DisplayItem (title, link) {
            var htmlcode = '<i><a href="'+link+'" target="_blank">'+title+'</a><br /></i>';
            document.getElementById ('news').innerHTML += htmlcode;
        }
    </script>
</head>
<body>
    <xml src="news.xml" onDatasetComplete="OnNewsComplete ();"></xml>
    <div id="news"></div>
</body>

<?xml version="1.0" encoding="utf-8"?>
<news>
    <channel>
        <item>
            <title>Paula Abdul leaves American Idol</title>
            <description>Paula Abdul has officially confirmed that she won’t be returning to American Idol this season. "With sadness in my heart, I’ve decided not to return to Idol," she wrote on her Twitter page.</description>
            <pubDate>Wed, August 5, 2009 19:52:31 +0200</pubDate>
            <link>http://www.tribute.ca/news/index.php/its-official-paula-abdul-leaves-american-idol/2009/08/05/</link>
        </item>

        <item>
            <title>Criminal Minds star Moore hit by car</title>
            <description>Shemar Moore, 39, who plays FBI Agent Derek Morgan in the CBS drama Criminal Minds, was hit by a car while bicycling in Los Angeles last Saturday.</description>
            <pubDate>Thu, August 4, 2009 13:28:12 +0200</pubDate>
            <link>http://www.tribute.ca/news/index.php/criminal-minds-star-moore-hit-by-car/2009/08/04/</link>
        </item>

        <item>
            <title>Madonna writes love song for ex-husband</title>
            <description>Madonna has sparked speculation that she wants to get back with her ex-husband, Guy Ritchie, after writing a love song for him in which she calls him her "eternal love".</description>
            <pubDate>Fri, July 31, 2009 04:01:50 +0200</pubDate>
            <link>http://www.tribute.ca/news/index.php/madonna-writes-love-song-for-ex-husband/2009/07/31/</link>
        </item>
    </channel>
</news>