Предусмотрено две одноименных функции: РаботаСФайлами.ДобавитьФайл для вызова с сервера РаботаСФайламиКлиент.ДобавитьФайл для вызова с клиента

1. Для вызова с сервера

Создает объект в справочнике для хранения файла и заполняет его реквизиты переданными свойствами.

Синтаксис

Функция ДобавитьФайл(ПараметрыФайла,
                    Знач АдресФайлаВоВременномХранилище,
                    Знач АдресВременногоХранилищаТекста = "",
                    Знач Описание = "",
                    Знач НоваяСсылкаНаФайл = Неопределено) Экспорт

Параметры

• ПараметрыФайла — см. РаботаСФайлами.ПараметрыДобавленияФайла.
• АдресФайлаВоВременномХранилище — Строка - адрес, указывающий на двоичные данные во временном хранилище.
• АдресВременногоХранилищаТекста — Строка - адрес, указывающий на извлеченный текст из файла во временном хранилище.
• Описание — Строка - текстовое описание файла.
• НоваяСсылкаНаФайл — Неопределено - если у владельца файла только один справочник хранения файлов.
  • ОпределяемыйТип.ПрисоединенныйФайл - ссылка на элемент справочника хранения файлов, которую следует использовать для добавляемого файла. Должна соответствовать одному из типов справочников хранения файлов владельца файлов. Ссылка может быть получена функцией НоваяСсылкаНаФайл.

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

ОпределяемыйТип.ПрисоединенныйФайл - ссылка на созданный присоединенный файл.

Пример вызова

Результат = РаботаСФайлами.ДобавитьФайл(ПараметрыФайла, АдресФайлаВоВременномХранилище, АдресВременногоХранилищаТекста, Описание, НоваяСсылкаНаФайл)

Доступность

Сервер, Толстый клиент, Внешнее соединение

2. Для вызова с клиента

Открывает диалог выбора файлов для помещения в программу одного выбранного файла.

Синтаксис

Процедура ДобавитьФайл(ОбработчикРезультата, ВладелецФайла, ФормаВладелец, РежимСоздания = Неопределено, 
ПараметрыДобавления = Неопределено) Экспорт

Параметры

• ОбработчикРезультата — ОписаниеОповещения - содержит описание процедуры, вызов которой будет произведен после добавления файла со следующими параметрами:
  • Результат - Структура: ** ФайлСсылка - ОпределяемыйТип.ПрисоединенныйФайл - ссылка на элемент справочника с файлом, если он был добавлен, иначе Неопределено. ** ФайлДобавлен - Булево - Истина, если файл добавлен. ** ТекстОшибки - Строка - текст ошибки, если файл не был добавлен.
  • ДополнительныеПараметры - Произвольный - значение, указанное при создании объекта оповещения.
• ВладелецФайла — ОпределяемыйТип.ВладелецПрисоединенныхФайлов - папка файлов или объект, к которому требуется прикрепить добавляемый файл.
• ФормаВладелец — ФормаКлиентскогоПриложения - форма, из которой вызвано создание файла.
• РежимСоздания — Неопределено
  • Число - режим создания файла:
  • Неопределено - показать диалог выбора режима создания файла.
  • Число - создать файл указанным способом:
• 1 — из шаблона (копированием другого файла);
• 2 — с компьютера (из файловой системы);
• 3 — со сканера.
• ПараметрыДобавления — Структура - дополнительные параметры добавления файлов:
  • МаксимальныйРазмер - Число - ограничение на размер файла (в мегабайтах), загружаемого из файловой системы. Если принимает значение 0, проверка размера не проводится. Свойство игнорируется, если принимает значение больше, чем указано в константе МаксимальныйРазмерФайла.
  • ФильтрДиалогаВыбора - Строка - фильтр, устанавливаемый в диалог выбора при добавлении файла. Формат см. в свойстве Фильтр объекта ДиалогВыбораФайла в синтакс-помощнике.
  • НеОткрыватьКарточку - Булево - действие после создания. Если принимает значение Истина, карточка файла не будет открыта после создания, иначе - карточку файла будет открыта.

Пример вызова

РаботаСФайламиКлиент.ДобавитьФайл(ОбработчикРезультата, ВладелецФайла, ФормаВладелец, РежимСоздания, ПараметрыДобавления)

Доступность

Тонкий клиент, Толстый клиент