File NN n/a  IE 4.0  ECMA n/a

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

 
Создание:

Объект File может быть создан методом FileSystemObject.GetFile или получен при просмотре коллекции Folder.Files.


Свойства:


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

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

Бит Атрибут Можно изменять
0 Обычный файл (все атрибуты сброшены). -
1 Файл только для чтения. Да
2 Скрытый файл. Да
4 Системный файл. Да
8 Метка дискового тома. Нет
16 Папка или каталог. Нет
32 Файл был изменен после архивирования. Да
64 Ссылка или сокращение. Нет
128 Сжатый файл. Нет
 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("c:\\test.txt");
f.Attributes = f.Attributes - 1;

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

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

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

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("c:\\config.sys");
document.write(f.DateCreated);

 
Возвращаемое значение:
Текст следующего вида: Fri Jul 7 01:04:53 UTC+0600 2000.

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

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

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("c:\\config.sys");
document.write(f.DateLastAccessed);

 
Возвращаемое значение:
Текст следующего вида: Fri Jul 7 01:04:53 UTC+0600 2000.

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

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

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("c:\\config.sys");
document.write(f.DateLastModified);

 
Возвращаемое значение:
Текст следующего вида: Fri Jul 7 01:04:53 UTC+0600 2000.

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

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

 

Пример:

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

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

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

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

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("c:\\config.sys");
var x = f.Name; // x равно "CONFIG.SYS"

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

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

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

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("c:\\config.sys");
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.GetFile("c:\\config.sys");
var x = f.Path; // x равно "C:\\CONFIG.SYS"

 
Возвращаемое значение:
Строка - путь к файлу

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

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

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("C:\\Multimedia Files\\Graphics\\Animations\\Airpane.gif");
var x = f.ShortName; // x равно "AIRPLANE.GIF"

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

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

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

 

Пример:

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

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

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

Свойство Size возвращает размер данного файла в байтах.

 

Пример:

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

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

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

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

 

Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile("C:\\Multimedia Files\\Graphics\\Animations\\Airpane.gif");
var x = f.Type; // x равно "GIF Image"

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

Методы:


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

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

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

Пример:

следующий сценарий копирует файл CONFIS.SYS в папку d:\Temp.

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

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

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

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

Пример:

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

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

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

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

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

Пример:

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

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

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

OpenAsTextStream() NN n/a  IE 4.0  ECMA n/a
объект.OpenAsTextStream(how [, format])  
 

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

 
Возвращаемое значение
новый объект TextStream

HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека