IPConnection.ReceiveFile

From SunFlurry wiki
Revision as of 08:51, 7 February 2021 by Admin (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  ReceiveFile (Обмен данными)
Объект:Объект IP
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, разрыв соединения, системная ошибка
Визуальность:Нет

TCP/IP функция получает файл по установленному соединению. Для отсылки файла с удаленной стороны необходимо использовать функцию SendFile. Имя файла может иметь международные символы. Кроме содержимого файла принимается и устанавливается дата последней записи в файл (может использоваться для контроля необходимости обновления файла). Если имя файла не задано, будет использовано оригинальное имя файла, которое принимается с удаленной стороны. Если путь сохранения файла не задан, файл будет сохранен во временную папку текущего сеанса операционной системы. Файл может быть получен как локально, так в каталог сервера. Функцию можно использовать как для блокирующих, так и для не блокирующих соединений. Если соединение будет разорвано до успешного принятия данных, функция вызовет исключение. Для передачи очень больших файлов, желательно создать свой протокол передачи, так как данная функция не возвращается до тех пор, пока весь файл не будет принят.

Синтаксис

IPConnection.ReceiveFile(<Имя файла для получения (STRING)>,<Путь по которому сохранить файл (STRING)>):<Путь и имя полученного файла (STRING)>

Аргументы

  • <Имя файла для получения (STRING)> - (необязательный аргумент) Задает имя получаемого файла, так как с удаленной стороны передается имя отправляемого файла, этот аргумент не обязателен, если он опущен, будет использовано имя файла с удаленной стороны.
  • <Путь по которому сохранить файл (STRING)> - (необязательный аргумент) Путь для сохранения файла. Путь может быть как серверным и так и локальным (Имена файлов). Если аргумент опущен, файл будет принят во временную папку операционной системы. Функция возвращает имя и путь принятого файла.

Возвращаемое значение

Возвращается имя и путь принятого файла.

Примеры

//Пример принятия файла с помощью ReceiveFile
аКлиент:=IPConnection.Connect("127.0.0.1:8000");
аКлиент.ReceiveFile("testfile.txt","c:\");