Чтение онлайн

Метод	Описание
BuildPath(path, name)	Добавляет к заданному пути (параметр path ) новое имя (параметр name )
CopyFile(source, destination [, overwrite])	Копирует один или несколько файлов из одного места (параметр source ) в другое (параметр destination )
CopyFolder(source, destination [, overwrite])	Копирует каталог со всеми подкаталогами из одного места (параметр source ) в другое (параметр destination )
CreateFolder(foldername)	Создает новый каталог с именем foldername . Если каталог foldername уже существует, то произойдет ошибка
CreateTextFile(filename [/overwrite[, unicode]])	Создает новый текстовый файл с именем filename и возвращает указывающий на этот файл объект TextStream
DeleteFile(filespec [, force])	Удаляет файл, путь к которому задан параметром filespec
DeleteFolder(folderspec [, force])	Удаляет каталог, путь к которому задан параметром folderspec , вместе со всем его содержимым
DriveExists(drivespec)	Возвращает True , если заданное параметром drivespec устройство существует и False в противном случае
FileExists(filespec)	Возвращает True , если заданный параметром filespec файл существует и False в противном случае
FolderExists(folderspec)	Возвращает True , если заданный параметром folderspec каталог существует и False в противном случае
GetAbsolutePathName(pathspec)	Возвращает полный путь для заданного относительного пути pathspec (из текущего каталога)
GetBaseName(path)	Возвращает базовое имя (без расширения) для последнего компонента в пути path
GetDrive(drivespec)	Возвращает объект Drive , соответствующий диску, заданному параметром drivespec
GetDriveName(path)	Возвращает строку, содержащую имя диска в заданном пути. Если из параметра path нельзя выделить имя диска, то метод возвращает пустую строку (" ")
GetExtensionName(path)	Возвращает строку, содержащую расширение для последнего компонента в пути path . Если из параметра path нельзя выделить компоненты пути, то GetExtensionName возвращает пустую строку (""). Для сетевых дисков корневой каталог (\) рассматривается как компонент пути
GetFile(filespec)	Возвращает объект File , соответствующий файлу, заданному параметром filespec . Если файл, путь к которому задан параметром filespec , не существует, то при выполнении метода GetFile возникнет ошибка
GetFileName(pathspec)	Возвращает имя файла, заданного полным путем к нему. Если из параметра pathspec нельзя выделить имя файла, метод GetFileName возвращает пустую строку ("")
GetFolder(folderpec)	Возвращает объект Folder , соответствующий каталогу, заданному параметром folderspec . Если каталог, путь к которому задан параметром folderspec , не существует, при выполнении метода GetFolder возникнет ошибка
GetParentFolderName(path)	Возвращает строку, содержащую имя родительского каталога для последнего компонента в заданном пути. Если для последнего компонента в пути, заданном параметром path , нельзя определить родительский каталог, то метод возвращает пустую строку ("")
GetSpecialFolder(folderpec)	Возвращает объект Folder для некоторых специальных папок Windows, заданных числовым параметром folderspec
GetTempName	Возвращает случайным образом сгенерированное имя файла или каталога, которое может быть использовано для операций, требующих наличия временного файла или каталога
MoveFile(source, destination)	Перемещает один или несколько файлов из одного места (параметр source ) в другое (параметр destination )
MoveFolder(source, destination)	Перемещает один или несколько каталогов из одного места (параметр source ) в другое (параметр destination )
OpenTextFile(filename[, iomode[, create[, format]]])	Открывает заданный текстовый файл и возвращает объект TextStream для работы с этим файлом

Сами названия методов объекта

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

Для копирования нескольких файлов или каталогов в последнем компоненте параметра

можно указывать групповые символы "?" и "*"; в параметре

destination

групповые символы недопустимы. Например, следующий пример является корректным кодом:

А так писать нельзя:

Необязательный параметр

является логической переменной, определяющей, следует ли заменять уже существующий файл/каталог с именем (

overwrite=true

) или нет ().

При использовании методов

и процесс копирования прерывается после первой возникшей ошибки (как и в команде операционной системы).

Параметр

, используемый в методе, имеет значение в том случае, когда создаваемый файл уже существует. Если равно , то такой файл перепишется (старое содержимое будет утеряно), если же в качестве

overwrite

указано , то файл переписываться не будет. Если этот параметр вообще не указан, то существующий файл также не будет переписан.

Параметр

является логическим значением, указывающим, в каком формате (ASCII или Unicode) следует создавать файл. Если

unicode

равно , то файл создается в формате Unicode, если же

unicode

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

Для дальнейшей работы с созданным файлом, т.е. для записи или чтения информации, нужно использовать методы объекта

. Соответствующий пример сценария приведен в листинге 5.1.

Параметры

или

folderspec

, используемые в методах, могут содержать групповые символы "?" и "*" в последнем компоненте пути для удаления сразу нескольких файлов/каталогов.

Если параметр

равен или не указан вовсе, то с помощью методов или будет нельзя удалить файл/каталог с атрибутом "только для чтения" (read-only). Установка для

force

значения позволит сразу удалять такие файлы/каталоги.

Замечание

При использовании метода

DeleteFolder

неважно, является ли удаляемый каталог пустым или нет — он удалится в любом случае

Если заданный для удаления файл/каталог не будет найден, то возникнет ошибка.

Для дисководов со съемными носителями метод

вернет даже в том случае, если носитель физически отсутствует. Для того чтобы определить готовность дисковода, нужно использовать свойство соответствующего объекта .

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

приведем функцию , которая возвращает информацию о наличии диска, передаваемого в эту функцию в качестве параметра (листинг 5.2).