Глобальный контекст.ПоместитьФайл (Global context.PutFile)
Глобальный контекст (Global context)
ПоместитьФайл (PutFile)
Не рекомендуется использовать, начиная с версии 8.3.13.
Рекомендуется использовать:
Доступен, начиная с версии 8.2.
Синтаксис:
ПоместитьФайл(<Адрес>, <НачальноеИмяФайла>, <ВыбранноеИмяФайла>, <Интерактивно>, <УникальныйИдентификаторФормы>)Параметры:
<Адрес> (необязательный)
Адрес во временном хранилище, по которому должны быть помещены данные. Если значение параметра не задано или является пустой строкой, то будет создан новый файл. Расположение нового файла возвращается в данном параметре.
<НачальноеИмяФайла> (необязательный)
Путь к файлу, данные из которого будут помещены во временное хранилище.
Если параметр <Интерактивно> = Истина, то отображается диалог выбора файла и выбранный в диалоге путь возвращается в параметре <ВыбранноеИмяФайла>.
<ВыбранноеИмяФайла> (необязательный)
В параметре возвращается путь к файлу, указанный в диалоге выбора файла. Для неинтерактивного режима выбранное имя файла соответствует начальному имени файла.
В веб-клиенте значение параметра зависит от типа браузера.
Для FireFox 3 в параметре возвращается только имя файла без пути.
Для Internet Explorer возвращаемое значение зависит от настроек безопасности.
<Интерактивно> (необязательный)
Указывает использование интерактивного режима, при котором отображается диалог выбора файла. Этот файл будет помещен по указанному в параметре <Адрес> адресу во временное хранилище или по новому адресу, если второй параметр метода опущен.
Если значение параметра Истина, то метод отобразит стандартное диалоговое окно выбора файла, в котором можно выбрать файл для помещения в хранилище. В этом случае выбранный путь возвращается в параметре <Выбранное имя файла>.
В веб-клиенте параметр должен быть равен Истина. В противном случае будет сгенерировано сообщение об ошибке.
Значение по умолчанию: Истина.
<УникальныйИдентификаторФормы> (необязательный)
Уникальный идентификатор формы, который можно получить с помощью свойства УникальныйИдентификатор управляемой формы.
Файл помещается во временное хранилище и автоматически удаляется после удаления объекта формы.
Если параметр не указан, помещенное значение будет удалено, после очередного запроса сервера из общего модуля, при контекстном и неконтекстном серверном вызове из формы, при серверном вызове из модуля команды или при получении формы.
Возвращаемое значение:
Тип: Булево.Ложь - в параметре <Интерактивно> установлен интерактивный режим (Истина) и пользователь отказался от выполнения операции в диалоге выбора файла.
Описание:
Помещает файл из локальной файловой системы во временное хранилище.
Доступность:
Тонкий клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
Вызов метода выполняет обращение к серверу.
Примечание:
Если для конфигурации свойство РежимИспользованияМодальности установлено в НеИспользовать, следует использовать метод НачатьПомещениеФайла.См. также:
Глобальный контекст, метод НачатьПомещениеФайлаГлобальный контекст, метод ПоместитьФайлНаСерверАсинх
Глобальный контекст, метод ПоместитьФайлыНаСерверАсинх
Глобальный контекст, метод ПоместитьФайлы
Глобальный контекст, метод НачатьПомещениеФайлов
Использование в версии:
Доступен, начиная с версии 8.2.
Не рекомендуется использовать, начиная с версии 8.3.13.
Описание изменено в версии 8.3.18.