Параметры в квадратных скобках ([ ]) - не обязательные.
Свойства объекта File перечислены в табл. П5.2, а методы - в табл. П5.3.
Таблица П5.2. Свойства объекта File
|
Свойство |
Тип |
Атрибут |
Описание |
|
alias |
Boolean |
R |
Если true, объект ссылается на ярлык |
|
created |
Date |
R |
Дата создания файла |
|
encoding |
String |
R |
Кодировка |
|
eof |
Boolean |
R |
Конец файла |
|
error |
String |
R |
Сообщение, описывающее ошибку файловой системы |
|
exists |
Boolean |
R |
Если true, объект существует |
|
fsName |
String |
R |
Платформенно-зависимый полный путь к файлу |
|
hidden |
Boolean |
R/W |
Файл скрыт для отображения в системном браузере |
|
length |
Number |
R |
Размер файла в байтах |
|
lineFeed |
String |
R/W |
Тип символа переноса строки: windows для Windows, mac для Mac OS |
|
modified |
Date |
R |
Дата модификации файла |
Таблица П5.2 (окончание)
|
Свойство |
Тип |
Атрибут |
Описание |
|
паше |
String |
R |
Имя файла, без пути |
|
parent |
Folder |
R |
Папка, в которой расположен файл |
|
path |
String |
R |
Путь к файлу без его имени |
|
readonly |
Boolean |
R7W |
Если true, файл не может быть изменен или удален |
|
type |
String |
R |
Только в Mac OS: тип файла |
Таблица П5.3. Методы объекта File
|
Метод |
Описание |
|
close() |
Закрыть файл. В случае успеха возвращает true, иначе - false |
|
copy (target) |
Копировать файл в другое место. Если файл с таким именем существует, он перезаписывается. В случае успеха возвращает true, иначе - false. Здесь target - путь к файлу или сам файл |
|
createAlias(to File) |
Создать ярлык |
|
execute() |
Открыть файл в соответствующем приложении (аналог двойного щелчка в Проводнике) |
|
open (mode [, type] [, creator]) |
Открыть файл в определенном режиме. Допустимые режимы: • г (read) - только для чтения; • w (write) - для записи; • е (edit) - для чтения и записи. Необязательные параметры - только для Mac OS: • type - тип созданного файла; • creator- программа-создатель файла |
|
openDlg ( [prompt] [, select]) |
Отобразить диалоговое окно для открытия файла. Необязательные параметры: • prompt - текст, который будет отображаться в диалоговом окне; • select - разделенный точкой с запятой список типов файлов, которые будут отображаться в диалоговом окне |
|
read( [char]) |
Прочитать содержимое файла. Необязательный параметр char- количество символов, которые будут прочитаны |
Таблица П5.3 (окончание)
|
Метод |
Описание |
|
readln() |
Прочитать строку файла |
|
remove() |
Удалить файл. Происходит в обход Корзины. В случае успеха возвращает true. В случае удаления ярлыка удаляет именно ярлык, а не связанный с ним файл |
|
rename(newName) |
Переименовать файл на newName. Здесь newName - это новое имя файла или папки, без пути. В случае успеха возвращает true |
|
resolve() |
Определить реальный файл по его ярлыку. Возвращает null, если файл не найден |
|
saveDlg( [prompt] [, select]) |
Отобразить диалоговое окно для сохранения файла. Необязательные параметры: • prompt - текст, который будет отображаться в диалоговом окне; • select - разделенный точкой с запятой список типов файлов, которые будут отображаться в диалоговом окне |
|
seek(pos, mode) |
Переместить указатель в нужную позицию в файле |
|
write (text[, text, text]) |
Записать текст в файл. В случае успеха возвращает true |
|
writeln (text [, text, text]) |
Записать текст в файл и в конце добавить символ перевода строки. В случае успеха возвращает true |
Работа с этими объектами строится таким образом. Сначала создается объект требуемого типа и через его свойства ему устанавливается ссылка на физический файл на диске, после чего с ним возможны остальные операции (открытие, чтение, изменение содержимого, закрытие и т. п.). При открытии файла одним объектом операционная система блокирует доступ к нему для других объектов.