Открывает файл архива для чтения.
Синтаксис
Открыть(<ИмяФайла>, <Пароль>, <ТипФайлаАрхива>)Открыть(<Поток>, <Пароль>, <ТипФайлаАрхива>)Полное описание, параметры и ограничения
ЧтениеФайлаАрхива.Открыть (ArchiveFileReader.Open)
ЧтениеФайлаАрхива (ArchiveFileReader)
Открыть (Open)
Доступен, начиная с версии 8.3.26.
Вариант синтаксиса: Открыть для чтения из файла
Синтаксис:
Открыть(<ИмяФайла>, <Пароль>, <ТипФайлаАрхива>)
Параметры:
<ИмяФайла> (обязательный)
Тип: Строка.
Имя файла архива, который требуется открыть для чтения.
<Пароль> (необязательный)
Тип: Строка.
Пароль для доступа к файлу архива, если файл зашифрован.
<ТипФайлаАрхива> (необязательный)
Тип: ТипФайлаАрхива.
Тип файла архива, который требуется открыть для чтения.
По умолчанию тип определяется по расширению имени файла.
Описание варианта метода:
Метод открывает файл архива для чтения.
Вариант синтаксиса: Установить поток
Синтаксис:
Открыть(<Поток>, <Пароль>, <ТипФайлаАрхива>)
Параметры:
<Поток> (обязательный)
Тип: Поток, ПотокВПамяти, ФайловыйПоток.
Поток, из которого будут прочитаны данные архива.
<Пароль> (необязательный)
Тип: Строка.
Пароль для доступа к архиву, если архив зашифрован.
<ТипФайлаАрхива> (необязательный)
Тип: ТипФайлаАрхива.
Тип файла архива, который требуется открыть для чтения.
По умолчанию, тип определяется по расширению имени файла.
Описание варианта метода:
Устанавливает поток для чтения архива.
Описание:
Открывает файл архива для чтения.
Доступность:
Тонкий клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.26.
Методическая информация
Практические примеры
Сформировать архив как ДвоичныеДанные и прочитать его из потока
Упаковываем свой временный текст в двоичные данные, открываем поток архива и проверяем список файлов без распаковки.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Современные объекты доступны с 8.3.26; пример предназначен для вашей платформы 8.5.1.1343.
Добавить принимает путь к файлу, поэтому создаётся один уникальный временный источник. Сам архив остаётся в памяти.
Для ПолучитьДвоичныеДанные создавайте запись без параметров и не вызывайте перед этим Открыть.
ИсходныйФайл = ПолучитьИмяВременногоФайла("txt");
Поток = Неопределено;
Чтение = Неопределено;
Попытка
Документ = Новый ТекстовыйДокумент;
Документ.УстановитьТекст("Учебный пакет");
Документ.Записать(ИсходныйФайл, КодировкаТекста.UTF8);
Запись = Новый ЗаписьФайлаАрхива;
Запись.Добавить(ИсходныйФайл);
ДанныеАрхива = Запись.ПолучитьДвоичныеДанные();
Сообщить(ДанныеАрхива.Размер());
Поток = ДанныеАрхива.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеФайлаАрхива(Поток);
Сообщить(Чтение.Элементы.Количество());
Для Каждого Элемент Из Чтение.Элементы Цикл
Сообщить(Элемент.Имя);
КонецЦикла;
Чтение.Закрыть();
Чтение = Неопределено;
Поток.Закрыть();
Поток = Неопределено;
// Второе открытие того же пакета через неинициализированное чтение.
Поток = ДанныеАрхива.ОткрытьПотокДляЧтения();
Чтение = Новый ЧтениеФайлаАрхива;
Чтение.Открыть(Поток);
Если Чтение.Элементы.Количество() <> 1 Тогда
ВызватьИсключение "Повторное чтение пакета не совпало";
КонецЕсли;
Чтение.Закрыть();
Чтение = Неопределено;
Поток.Закрыть();
Поток = Неопределено;
УдалитьФайлы(ИсходныйФайл);
Исключение
Если Чтение <> Неопределено Тогда
Чтение.Закрыть();
КонецЕсли;
Если Поток <> Неопределено Тогда
Поток.Закрыть();
КонецЕсли;
УчебныйФайл = Новый Файл(ИсходныйФайл);
Если УчебныйФайл.Существует() Тогда
УдалитьФайлы(ИсходныйФайл);
КонецЕсли;
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Сохраняем исходный текст в один собственный временный файл.
Неинициализированная запись собирает пакет; ПолучитьДвоичныеДанные возвращает готовый архив и завершает запись.
Открываем новый поток чтения двоичных данных и передаём его конструктору чтения архива.
После проверки количества закрываем чтение и поток; повторяем проверку через Новый без параметров и Открыть. Удаляем источник.
Как проверить результат
Размер пакета больше нуля; в коллекции ровно один элемент с расширением txt.
Оба открытия возвращают количество 1. Исходный временный файл удалён.
Не вызывайте ПолучитьДвоичныеДанные после конструктора записи по имени файла: это другой способ работы, запрещённый описанием данного метода.
Ожидаемый результат
Готовый архив хранится в ДвоичныеДанные; файловый архив не создаётся.
На что обратить внимание
Современные объекты доступны с 8.3.26; пример предназначен для вашей платформы 8.5.1.1343.
Не закрывайте поток раньше объекта чтения архива. После завершения не используйте закрытые объекты.
Для больших пакетов память ограничена; потоковый или файловый вариант выбирается исходя из объёма данных.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.