This documentation is archived and is not being maintained.

moveFirst Method

Visual Studio 2010

Resets the current item in an Enumerator object to the first item.

Copy 
function moveFirst()

If there are no items in the collection, the current item is set to undefined.

In following example, the moveFirst method is used to evaluate members of the Drives collection from the beginning of the list:

Copy 
function ShowDrives()
{
    var s = "";
    var bytesPerGB = 1024 * 1024 * 1024;

    var fso = new ActiveXObject("Scripting.FileSystemObject");
    var e = new Enumerator(fso.Drives);

    e.moveFirst();
    while (e.atEnd() == false)
    {
        var drv = e.item();

        s += drv.Path + " - ";

        if (drv.IsReady)
        {
            var freeGB = drv.FreeSpace / bytesPerGB;
            var totalGB = drv.TotalSize / bytesPerGB;

            s += freeGB.toFixed(3) + " GB free of ";
            s += totalGB.toFixed(3) + " GB";
        }
        else
        {
            s += "Not Ready";
        }

        s += "\n";

        e.moveNext();
    }
    return(s);
}
Show: