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

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

Возвращает структурированную информацию о файле. Используется в различных командах работы с файлами и как значение параметра ДанныеФайла других процедур и функций.

Синтаксис

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

Параметры

• ФайлСсылка — ОпределяемыйТип.ПрисоединенныйФайл - ссылка на элемент справочника с файлом.
• ИдентификаторФормы — УникальныйИдентификатор - уникальный идентификатор формы, во временное хранилище которой надо поместить файл и вернуть адрес в свойстве СсылкаНаДвоичныеДанныеФайла.
• ПолучатьСсылкуНаДвоичныеДанные — Булево - если передать Ложь, то ссылка на двоичные данные в СсылкаНаДвоичныеДанныеФайла не будет получена, что существенно ускорит выполнение для больших двоичных данных.
• ДляРедактирования — Булево - если указать Истина, то файл будет захвачен для редактирования.

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

см. РаботаСФайлами.ДанныеФайла

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

Результат = РаботаСФайламиКлиент.ДанныеФайла(ФайлСсылка, ИдентификаторФормы, ПолучатьСсылкуНаДвоичныеДанные, ДляРедактирования)

Доступность

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

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

Возвращает сведения о файле. Используется в различных командах работы с файлами и как значение параметра ДанныеФайла в других процедурах и функциях.

Синтаксис

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

Параметры

• ПрисоединенныйФайл — ОпределяемыйТип.ПрисоединенныйФайл - ссылка на элемент справочника с файлом.
• ДополнительныеПараметры — см. РаботаСФайламиКлиентСервер.ПараметрыДанныхФайла.
• УдалитьПолучатьСсылкуНаДвоичныеДанные — Булево - устарел, следует использовать ДополнительныеПараметры.
• УдалитьДляРедактирования — Булево - устарел, следует использовать ДополнительныеПараметры.

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

Структура, Неопределено - информация о присоединенном файле. Если файл не найден или отсутствует часть обязательной информации о файле и свойство ВызыватьИсключение параметра ДополнительныеПараметры принимает значение Ложь, возвращаемое значение - Неопределено. Если файл не найден или отсутствует часть обязательной информации о файле и ВызыватьИсключение отсутствует или принимает значение Истина, вызывает исключение. Свойства структуры:

• Ссылка - ОпределяемыйТип.ПрисоединенныйФайл - ссылка на элемент справочника с файлом.
• СсылкаНаДвоичныеДанныеФайла - Строка - адрес во временном хранилище, по которому помещены данные файла.
• Владелец - ОпределяемыйТип.ВладелецФайлов - ссылка объект-владелец файла.
• ОтносительныйПуть - Строка - относительный путь файла.
• ДатаМодификацииУниверсальная - Дата - дата изменения файла в UTC.
• ИмяФайла - Строка - имя файла, например, "документ.txt".
• Наименование - Строка - наименование файла (в справочнике хранения файлов).
• Расширение - Строка - расширение файла без точки.
• Размер - Число - размер файла в байтах.
• Редактирует - СправочникСсылка.Пользователи
  • СправочникСсылка.ВнешниеПользователи
  • Неопределено - пользователь, занявший файл для редактирования.
• ДатаЗаема - Дата - дата и время, когда файл был открыт для редактирования.
• ПодписанЭП - Булево - признак того, что файл подписан.
• Зашифрован - Булево - признак того, что файл зашифрован.
• МассивСертификатовШифрования - см. ЭлектроннаяПодпись.СертификатыШифрования
• ПометкаУдаления - Булево - признак того, что файл помечен на удаление.
• НавигационнаяСсылка - Строка - навигационная ссылка на файл.
• ХранитьВерсии - Булево - признак того, что у файла хранятся версии.
• ТекущаяВерсия - ОпределяемыйТип.ПрисоединенныйФайл - если справочник файлов поддерживает создание версий, содержит ссылку на текущую версию файла. В ином случае содержит ссылку на файл.
• Версия - ОпределяемыйТип.ПрисоединенныйФайл - аналогично выше.
• НомерВерсии - Число - если справочник файлов поддерживает создание версий, содержит номер текущей версии файла, иначе - 0.
• АвторТекущейВерсии - СправочникСсылка.УчетныеЗаписиСинхронизацииФайлов
  • СправочникСсылка.Пользователи
  • СправочникСсылка.ВнешниеПользователи - пользователь, отредактировавший файл.
• Том - СправочникСсылка.ТомаХраненияФайлов - том хранения файла.
• Автор - СправочникСсылка.УчетныеЗаписиСинхронизацииФайлов
  • СправочникСсылка.Пользователи
  • СправочникСсылка.ВнешниеПользователи - автор файла.
• СтатусИзвлеченияТекста - Строка - статус извлечения текста из файла.
• ПолноеНаименованиеВерсии - Строка - если справочник файлов поддерживает создание версий, содержит полное наименование текущей версии файла. В ином случае содержит полное наименование файла.
• КодировкаТекущейВерсии - Строка - кодировка текстового файла.
• НаЧтение - Булево - признак того, что файл редактируется пользователем, отличным от текущего.
• ПолноеИмяФайлаВРабочемКаталоге - Строка - путь к файлу в рабочем каталоге.
• ВРабочемКаталогеНаЧтение - Булево - файл в рабочем каталоге помечен только для чтения.
• РабочийКаталогВладельца - Строка - путь к рабочему каталогу владельца.
• ПапкаДляСохранитьКак - Строка - путь к каталогу сохранения.
• ФайлРедактируется - Булево - признак того, что файл занят для редактирования.
• ФайлРедактируетТекущийПользователь - Булево - признак того, что файл занят для редактирования текущим пользователем.
• Кодировка - Строка - кодировка текстового файла.
• Служебный - Булево - признак того, что файл является служебным.

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

// В этом примере установка идентификатора формы в параметре ДополнительныеПараметры предотвращает преждевременную
// очистку временного хранилища из-за возможных серверных вызовов при открытии файлов (например,
// если файл зашифрован или когда открывается форма текстового или табличного редактора).
// Открытие нескольких файлов.
ПараметрыДанныхФайла = РаботаСФайламиКлиентСервер.ПараметрыДанныхФайла();
ПараметрыДанныхФайла.ИдентификаторФормы = УникальныйИдентификатор;
Пока Выборка.Следующий() Цикл
 МассивДанныхФайлов.Добавить(РаботаСФайлами.ДанныеФайла(Выборка.Файл, ПараметрыДанныхФайла));
КонецЦикла;

Доступность

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