События. Возвращаясь к описанию компонента NMFTP, приведем в табл

Методы

Возвращаясь к описанию компонента NMFTP, приведем в табл. П1.8 его основные методы.

Таблица П1.8. Методы компонента NMFTP

Метод	Описание
Allocate	Вызывается для резервирования объема дискового пространства в количестве байтов, указанном в его параметре. Этот метод вызывается перед началом загрузки файла на сервер. При работе с большинством серверов вызывать этот метод не требуется
ChangeDir	Изменяет текущий каталог на указанный в своем параметре. Допускается использование абсолютных и относительных путей
Connect	Устанавливает соединение с сервером, параметры которого указаны в соответствующих полях компонента
Delete	Удаляет файл, имя которого указано в параметре метода. Допускается дополнительное указание абсолютных и относительных путей вместе с именем
DoCommand	Отправляет на сервер запрос на выполнение команды, указанной в качестве параметра. Существует набор стандартных команд, выполняемых FTP-сервером, которые касаются взаимодействия с клиентом

Download	Вызывается для загрузки файлов с сервера на локальный компьютер. В качестве параметров выступают имена (вместе с путями) исходного файла на сервере и конечного — на компьютере клиента
DownloadRestore	Вызывается для продолжения предыдущей попытки загрузить файл, в случае неудачного завершения последней. Для работы метода сервер должен поддерживать режим возобновления загрузки (большинство серверов его поддерживают)
List	Вызывается для получения подробной информации о содержимом текущего каталога
MakeDirectory	Создает на сервере новый каталог с названием, указанным в качестве параметра. Допускается дополнительное указание абсолютного и относительного пути к создаваемому каталогу
Mode	Характеризует, в каком формате передаются и принимаются данные при приеме/отправке файлов с сервера
Nlist	Выполняет запрос о содержимом текущего каталога. В отличие от метода List, данные атрибутов файлов и каталогов не загружаются, что может значительно сокращать время выполнения операции
Reinitialize	Прекращает текущие операции с сервером и выполняет новое соединение с ним
Remove Dir	Удаляет каталог, имя которого указано в параметре метода
Rename	Переименовывает файл, имя которого указано в качестве первого параметра. Вторым параметром является новое имя
Upload	Выполняет загрузку файла на сервер. Первым параметром является путь и имя исходного, а вторым — конечного файлов
UploadAppend	Аналогично предыдущему, за исключением того, что в случае, если на сервере уже имеется файл с именем, указанным в качестве параметра загрузки, Upload его перезаписывает, а UploadAppend дописывает содержимое локального файла в конец целевого
OploadRestore	Возобновляет процесс передачи содержимого файла на сервер. В качестве параметров служат две строки, содержащие имена локального и конечного файлов, а также число — текущая позиция чтения/записи файла, содержимое файла под которой не было передано в прошлый раз
UploadUnique	Сохраняет локальный файл в текущем каталоге сервера под именем, аналогичным исходному

При работе с объектом NMFTP могут возникать события, приведенные в табл. П1.9.

Таблица П1.9. Важнейшие события объекта NMFTP

Событие	Описание
OnAuthenticationFailed	Возникает, когда проверка имени пользователя и пароля закончилась неудачей
OnAuthenticationNeeded	Возникает, когда для входа на FTP-сервер требуется указание имени пользователя и пароля (или, возможно, параметров анонимного входа, описанных выше)
OnFailure	Является следствием неудачного завершения какой-либо команды, переданной на выполнение FTP-серверу
OnSuccess	Обратно предыдущему событию
OnTransactionStart	Возникает при начале процесса передачи данных от сервера к клиенту
OnTransactionStop	Возникает при прекращении передачи данных
OnUnSupportedFunction	Является следствием неудачной попытки выполнения какой-либо команды, переданной FTP-серверу, вследствие того, что она не поддерживается сервером

Дата добавления: 2014-12-29