ФайловыйПоток / FileStream

Специализированная версия объекта Поток для работы данными, расположенными в файле на диске. Предоставляет возможность чтения из потока, записи в поток и изменения текущей позиции. По умолчанию, все операции с файловым потоком являются буферизированными, размер буфера по умолчанию - 8 КБ. Размер буфера можно изменить, в том числе - полностью отключить буферизацию при вызове конструктора. Следует учитывать, что помимо буферизации существует кэширование чтения и записи файлов в операционной системе, на которое невозможно повлиять программно.

Свойства

ДоступнаЗапись / CanWrite

Доступ: Чтение

Тип значения: Булево (Boolean)

Признак доступности записи в поток.

ДоступноИзменениеПозиции / CanSeek

Доступ: Чтение

Тип значения: Булево (Boolean)

Признак доступности произвольного изменения позиции чтения/записи в потоке.

ДоступноЧтение / CanRead

Доступ: Чтение

Тип значения: Булево (Boolean)

Признак доступности чтения из потока.

ДоступенТаймаут / CanTimeout

Доступ: Чтение

Тип значения: Булево (Boolean)

Признак доступности установки таймаута чтения/записи в потоке.

ТаймаутЧтения / ReadTimeout

Доступ: Чтение/Запись

Тип значения: Число (int)

Время в миллисекундах, отведенное потоку на операцию чтения.

ТаймаутЗаписи / WriteTimeout

Доступ: Чтение/Запись

Тип значения: Число (int)

Время в миллисекундах, отведенное потоку на операцию записи.

ИмяФайла / FileName

Доступ: Чтение

Содержит полное имя файла, включая путь

Методы

Закрыть / Close()

Вызов данного метода завершает работу с потоком. При попытке вызвать любой метод объекта, кроме метода Закрыть, будет вызвано исключение. При повторном вызове данного метода никаких действий выполняться не будет. Выполняемое действие зависит от используемого типа потока.

Записать / Write()

Записывает в поток заданное количество байтов из буфера по заданному смещению. Если в буфере меньше данных, чем требуется записать, вызывается исключение о недостаточном количестве данных в буфере. Запись в поток возможна только, если поток поддерживает запись. В противном случае при вызове метода будет вызвано исключение.

Параметры

КопироватьВ / CopyTo()

Копирует данные из текущего потока в другой поток.

Параметры

Перейти / Seek()

Сдвигает текущую позицию потока на заданное количество байтов относительно начальной позиции. Если указано отрицательное смещение, позиция сдвигается в направлении к началу потока. Если изменение позиции недоступно (ДоступноИзменениеПозиции установлено в Ложь), будет сгенерировано исключение.

Параметры

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

Числовым типом может быть представлено любое десятичное число. Над данными числового типа определены основные арифметические операции: сложение, вычитание, умножение и деление. Максимально допустимая разрядность числа 38 знаков.

ПолучитьПотокТолькоДляЧтения / GetReadonlyStream()

Возвращает поток, который разделяет данные и текущую позицию с данным потоком, но не разрешает запись.

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

Прочитать / Read()

Выполняет чтение заданного количества байтов в указанный буфер по указанному смещению. Текущая позиция смещается вперед на фактическое количество прочитанных байтов. Чтение из потока возможно только, если поток поддерживает чтение. В противном случае, будет вызвано исключение. При чтении размер целевого буфера не меняется, а его содержимое перезаписывается фактически прочитанными данными. Если в буфере недостаточно места для записи прочитанных данных, происходит ошибка переполнения.

Параметры

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

Возвращает число прочитанных байт

Размер / Size()

Получает размер данных в байтах.

СброситьБуферы / Flush()

Сбрасывает все промежуточные буферы и производит запись всех незаписанных данных в целевое устройство.

ТекущаяПозиция / CurrentPosition()

Возвращает текущую позицию в потоке.

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

Числовым типом может быть представлено любое десятичное число. Над данными числового типа определены основные арифметические операции: сложение, вычитание, умножение и деление. Максимально допустимая разрядность числа 38 знаков.

УстановитьРазмер / SetSize()

Устанавливает размер потока. Если текущий размер превышает заданный, поток будет сокращен до заданного размера, а информация, превышающая заданный размер, будет потеряна. Если текущий размер потока меньше заданного, то содержимое потока между старым и новым размером не определено.

Параметры

Конструкторы

С указанием режима открытия

С указанием режима открытия и уровня доступа