Глобальный контекст.ПоместитьФайлНаСерверАсинх (Global context.PutFileToServerAsync)

Глобальный контекст (Global context)

ПоместитьФайлНаСерверАсинх (PutFileToServerAsync)

Доступен, начиная с версии 8.3.18.

Вариант синтаксиса: По пути файла на диске

Синтаксис:

ПоместитьФайлНаСерверАсинх(<ОписаниеОповещенияОХодеВыполнения>, <ОписаниеОповещенияПередНачалом>, <Адрес>, <ПутьКФайлу>, <УникальныйИдентификаторФормы>)

Параметры:

<ОписаниеОповещенияОХодеВыполнения> (необязательный)

Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана несколько раз по мере помещения файла. Количество раз и время вызова не определено строго. Оповещение будет вызвано со следующими параметрами:

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, помещаемый во временное хранилище.
<Помещено> - тип: Число. Процент помещенной части файла.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписаниеОповещенияПередНачалом> (необязательный)

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

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, готовый к помещению во временное хранилище.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено (в этом случае никакие другие оповещения вызваны не будут). Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<Адрес> (необязательный)

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

<ПутьКФайлу> (обязательный)

Тип: Строка.
Путь к файлу на диске.

<УникальныйИдентификаторФормы> (необязательный)

Тип: УникальныйИдентификатор.
Уникальный идентификатор формы, который можно получить с помощью свойства УникальныйИдентификатор формы клиентского приложения. Файл помещается во временное хранилище и автоматически удаляется после удаления объекта формы.
Если параметр не указан, то помещенное значение будет удалено после очередного запроса сервера из общего модуля, при контекстном и неконтекстном серверном вызове из формы, при серверном вызове из модуля команды или при получении формы.

Описание варианта метода:

Помещает файл, заданный путём на диске, из локальной файловой системы во временное хранилище.
Для работы в веб-клиенте требуется расширение работы с файлами.
Обработчик <ОписаниеОповещенияОХодеВыполнения> в веб-клиенте вызовется только дважды: когда количество помещенных во временное хранилище байт равно 0 и полному размеру файла.

Вариант синтаксиса: По ссылке на файл

Синтаксис:

ПоместитьФайлНаСерверАсинх(<ОписаниеОповещенияОХодеВыполнения>, <ОписаниеОповещенияПередНачалом>, <Адрес>, <СсылкаНаФайл>, <УникальныйИдентификаторФормы>)

Параметры:

<ОписаниеОповещенияОХодеВыполнения> (необязательный)

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, помещаемый во временное хранилище.
<Помещено> - тип: Число. Процент помещенной части файла.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписаниеОповещенияПередНачалом> (необязательный)

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, готовый к помещению во временное хранилище.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено (в этом случае никакие другие оповещения вызваны не будут). Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<Адрес> (необязательный)

<СсылкаНаФайл> (обязательный)

Тип: СсылкаНаФайл.
Ссылка на файл.

<УникальныйИдентификаторФормы> (необязательный)

Описание варианта метода:

Помещает файл, заданный ссылкой на файл, из локальной файловой системы во временное хранилище.
В веб-клиенте расширение работы с файлами не требуется.

Вариант синтаксиса: С диалогом выбора файла

Синтаксис:

ПоместитьФайлНаСерверАсинх(<ОписаниеОповещенияОХодеВыполнения>, <ОписаниеОповещенияПередНачалом>, <Адрес>, <ПараметрыДиалога>, <УникальныйИдентификаторФормы>)

Параметры:

<ОписаниеОповещенияОХодеВыполнения> (необязательный)

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, помещаемый во временное хранилище.
<Помещено> - тип: Число. Процент помещенной части файла.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписаниеОповещенияПередНачалом> (необязательный)

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, готовый к помещению во временное хранилище.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено (в этом случае никакие другие оповещения вызваны не будут). Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<Адрес> (необязательный)

<ПараметрыДиалога> (необязательный)

Тип: ПараметрыДиалогаПомещенияФайлов.
Структура, содержащая параметры диалога, который будет показан пользователю.

<УникальныйИдентификаторФормы> (необязательный)

Описание варианта метода:

Помещает файл, показывая диалог выбора файла из локальной файловой системы во временное хранилище.
В веб-клиенте расширение работы с файлами не требуется.

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

Тип: Обещание.
Результат выполнения обещания - описание помещенного во временное хранилище файла типа ОписаниеПомещенногоФайла, либо Неопределено, если помещение файла было отменено.

Описание:

Асинхронная функция. Помещает файл во временное хранилище.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

См. также:

Глобальный контекст, метод НачатьПомещениеФайла
Глобальный контекст, метод НачатьПомещениеФайлаНаСервер
Глобальный контекст, метод НачатьПомещениеФайловНаСервер
Глобальный контекст, метод ПоместитьФайл
Глобальный контекст, метод ПоместитьФайлы
Глобальный контекст, метод ПоместитьФайлыНаСерверАсинх

Использование в версии:

Доступен, начиная с версии 8.3.18.

Методическая информация