Folder

NN n/a   IE 4.0   ECMA n/a
 

Объект Folder обеспечивает доступ к отдельной папке.

 
Создание:

Объект Folder может быть создан методом FileSystemObject.GetFolder или получен чтением свойств Drive.RootFolder и File.ParentFolder.


Свойства:


Attributes NN n/a   IE 4.0   ECMA n/a
  Чтение/изменение
 

Свойство Attributes позволяет читать атрибуты данной папки и изменять некоторые из них. Полностью аналогично свойству File.Attributes.

 

DateCreated NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство DateCreated возвращает дату и время создания данной папки. Значение этого свойства имеет нестандартный тип VT_DATE стандарта COM. При присваивании строковой переменной оно автоматически преобразуется в строку указанного вида.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\Program Files");
document.write(f.DateCreated);

 
Возвращаемое значение:
Текст следующего вида: Mon Jul 12 20:43:58 UTC+0600 1999.

DateLastAccessed NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство DateLastAccessed возвращает дату и время последнего доступа к данной папке. Значение этого свойства имеет нестандартный тип VT_DATE стандарта COM. При присваивании строковой переменной оно автоматически преобразуется в строку указанного вида.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\Program Files");
document.write(f.DateLastAccessed);

 
Возвращаемое значение:
Текст следующего вида: Mon Jul 12 20:43:58 UTC+0600 1999.

DateLastModified NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство DateLastModified возвращает дату и время последней модификации данной папки. Значение этого свойства имеет нестандартный тип VT_DATE стандарта COM. При присваивании строковой переменной оно автоматически преобразуется в строку указанного вида.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\Program Files");
document.write(f.DateLastModified);

 
Возвращаемое значение:
Текст следующего вида: Mon Jul 12 20:43:58 UTC+0600 1999.

Drive NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство Drive возвращает букву, идентифицирующую диск, на котором находится данная папка. Если диск является сетевым и не отображен на логический диск, то возвращается пустая строка.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\Program Files");
var x = f.Drive; // x равно "C"

 
Возвращаемое значение:
Односимвольная строка

Files NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство Files возвращает коллекцию объектов File, соответствующих всем файлам, содержащимся в данной папке, включая скрытые и системные файлы. Для просмотра этой коллекции следует пользоваться объектом Enumerator.

 

Пример:

function ShowFileList(folderspec) {
var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder(folderspec);
var fc = new Enumerator(f.Files);
var s = "";
for (; !fc.atEnd(); fc.moveNext())
s += fc.item() + "<br>";
return s;
}
document.write(ShowFileList("c:\\"));

 
Возвращаемое значение:
Строка

IsRootFolder NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство IsRootFolder возвращает true, если данная папка является корневой, и false в противном случае

 
Возвращаемое значение:
Булево значение

name NN n/a   IE 4.0   ECMA n/a
  Чтение/изменение
 

Свойство Name позволяет читать и изменять имя данной папки.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\Program Files");
var x = f.Name; // x равно "Program Files"

 
Возвращаемое значение:
Строка

ParentFolder NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Метод ParentFolder возвращает объект Folder, соответствующий папке, содержащей данную папку. Если папка является корневой, то возвращается null.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\Program Files");
var p = f.ParentFolder;
var x = p.Path; // x равно "C:\\"

 
Возвращаемое значение:
Объект Folder

Path NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство Path возвращает путь доступа к данной папке.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\Program Files");
var x = f.Path; // x равно "C:\\Program Files"

 
Возвращаемое значение:
Строка

ShortName NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство ShortName возвращает имя данной папки в нотации MS-DOS (8 символов на имя файла и 3 символа на расширение).

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("C:\\Multimedia Files\\Graphics\\Animations");
var x = f.ShortName; // x равно "ANIMAT~1"

 
Возвращаемое значение:
Строка

ShortPath NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство ShortPath возвращает путь доступа к данной папке в нотации MS-DOS (8 символов на имя файла и 3 символа на расширение).

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("C:\\Multimedia Files\\Graphics\\Animations");
var x = f.ShortPath; // x равно "C:\\MULTIM~1\\GRAPHICS\\ANIMAT~1"

 
Возвращаемое значение:
Строка

size NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство Size возвращает суммарный размер в байтах всех файлов, содержащихся в данной папке и ее подпапках.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\");
var x = f.Size;

 
Возвращаемое значение:
Целое положительное число

SubFolders NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство SubFolders возвращает коллекцию объектов Folder, соответствующих всем папкам, содержащимся в данной папке, включая скрытые и системные папки. Для просмотра этой коллекции следует пользоваться объектом Enumerator.

 

Пример:

function ShowFileList(folderspec) {
var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder(folderspec);
var fc = new Enumerator(f.SubFolders);
var s = "";
for (; !fc.atEnd(); fc.moveNext())
s += fc.item() + "<br>";
return s;
}

document.write(ShowFileList("c:\\"));

 
Возвращаемое значение:
Строка

type NN n/a   IE 4.0   ECMA n/a
  Только чтение
 

Свойство Type возвращает тип данной папки. Тип - это текстовая строка, соответствующая расширению файла и хранящаяся в системном реестре.

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("C:\\Multimedia Files\\Graphics\\Animations");
var x = f.Type; // x равно "Папка с файлами" (в русифицированной Windows)

 
Возвращаемое значение:
Строка

Методы:


Copy() NN n/a   IE 4.0   ECMA n/a
объект.Copy(target [, flag]?)  
 

Метод Copy полностью копирует данную папку. Строка target задает имя результирующей папки, а необязательный аргумент flag указывает, следует ли заменять при копировании существующие файлы (по умолчанию он равен true, т. е. существующие файлы заменяются). Сам процесс копирования происходит так:

  • если папки с именем цель нет, то производится копирование папки;
  • если папка цель существует и флаг равен false, то метод завершается ошибкой, иначе делается попытка копирования источника поверх цели; при этом независимо от значения флага, попытка замены существующего файла с атрибутом "только для чтения" завершается ошибкой.

Пример: следующий сценарий копирует папку c:\ в папку d:\Temp.

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("c:\\");
f.Copy("d:\\Temp");

 
Возвращаемое значение
Нет
 
Параметры
target Имя результирующей папки
flag Булево значение

CreateTextFile() NN n/a   IE 4.0   ECMA n/a
объект.CreateTextFile(name [[, flag], unicode])  
 

Метод CreateTextFile создает текстовый файл с заданным именем. Он полностью аналогичен методу FileSystemObject.CreateTextFile.


Delete() NN n/a   IE 4.0   ECMA n/a
объект.Delete(flag)  
 

Метод Delete удаляет данную папку. При этом необязательный аргумент flag указывает, следует ли удалять файлы, имеющие атрибут "только для чтения" (по умолчанию он равен false, т. е. такие файлы не удаляются). Папка удаляется независимо от того, пуста оно или нет. Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFolder("C:\\Multimedia Files\\Graphics\\Animations");
f.Delete(true);

 
Возвращаемое значение
Нет
 
Параметры
flag Булево значение

Move() NN n/a   IE 4.0   ECMA n/a
объект.Move(target)  
 

Метод Move перемещает данную папку в другое место. При этом строка target задает имя результирующей папки. Сам процесс перемещения происходит так:

  • если папки с именем цель нет, то производится перемещение папки;
  • если папка цель существует, то метод завершается ошибкой.

Пример: следующий сценарий перемещает папку c:\ в папку d:\Temp (но делать этого не нужно!).

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("c:\\");
f.Move("d:\\Temp");

 
Возвращаемое значение
Нет
 
Параметры
target Имя результирующей папки