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