Класс FileStream

Предоставляет Stream в файле, поддерживая синхронные и асинхронные операции чтения и записи.

  • Пространство имен: System.IO
  • Сборка: mscorlib (в mscorlib.dll)

Иерархия наследования

Синтаксис

public class FileStream : Stream, IDisposable

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

ТипИмяОписание
КонструкторFileStream(String, FileMode) Инициализирует новый экземпляр класса FileStream с указанным путем и режимом создания.
КонструкторFileStream(String, FileMode, FileAccess) Инициализирует новый экземпляр класса FileStream с заданными путем, режимом создания и разрешением на чтение и запись.
КонструкторFileStream(String, FileMode, FileAccess, FileShare) Инициализирует новый экземпляр класса FileStream с заданными путем, режимом создания, разрешением на чтение и запись и разрешением на совместное использование.
КонструкторFileStream(String, FileMode, FileAccess, FileShare, Int32) Инициализирует новый экземпляр класса FileStream с заданными путем, режимом создания, разрешениями на чтение и запись и на совместное использование, а также размером буфера.
КонструкторFileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions) Инициализирует новый экземпляр класса FileStream с заданными путем, режимом создания, разрешениями на чтение, запись и совместное использование, доступом для других FileStreams к этому же файлу, размером буфера и дополнительными параметрами файла.
КонструкторFileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean) Инициализирует новый экземпляр класса FileStream с заданными путем, режимом создания, разрешениями на чтение и запись и совместное использование, размером буфера и синхронным или асинхронным состоянием.
КонструкторFileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) Инициализирует новый экземпляр класса FileStream с заданными путем, режимом создания, правами на доступ и совместное использование, размером буфера, дополнительными параметрами файла, управлением доступом и аудитом безопасности.
КонструкторFileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions) Инициализирует новый экземпляр класса FileStream с заданными путем, режимом создания, разрешениями на чтение, запись и совместное использование, размером буфера и дополнительными параметрами файла.
КонструкторFileStream(IntPtr, FileAccess) Инициализирует новый экземпляр класса FileStream для заданного дескриптора файла с заданными разрешениями на чтение и запись.
КонструкторFileStream(IntPtr, FileAccess, Boolean) Инициализирует новый экземпляр класса FileStream для заданного дескриптора файла с заданными разрешениями на чтение и запись и владельцем экземпляра FileStream.
КонструкторFileStream(IntPtr, FileAccess, Boolean, Int32) Инициализирует новый экземпляр класса FileStream для заданного дескриптора файла с заданными разрешениями на чтение и запись, владельцем экземпляра FileStream и размером буфера.
КонструкторFileStream(IntPtr, FileAccess, Boolean, Int32, Boolean) Инициализирует новый экземпляр класса FileStream для заданного дескриптора файла с заданными разрешениями на чтение и запись, владельцем экземпляра FileStream, размером буфера и синхронным или асинхронным состоянием.
КонструкторFileStream(SafeFileHandle, FileAccess) Инициализирует новый экземпляр класса FileStream для заданного дескриптора файла с заданными разрешениями на чтение и запись.
КонструкторFileStream(SafeFileHandle, FileAccess, Int32) Инициализирует новый экземпляр класса FileStream для заданного дескриптора файла с заданными разрешениями на чтение и запись и размером буфера.
КонструкторFileStream(SafeFileHandle, FileAccess, Int32, Boolean) Инициализирует новый экземпляр класса FileStream для заданного дескриптора файла с заданными разрешениями на чтение и запись, размером буфера и синхронным или асинхронным состоянием.

Свойства

ТипИмяОписание
СвойствоCanRead Получает значение, определяющее в текущем потоке наличие поддержки операций чтения.
СвойствоCanSeek Получает значение, определяющее в текущем потоке наличие поддержки операций поиска.
СвойствоCanTimeout Получает значение, которое показывает, может ли для данного потока истечь время ожидания. (Наследуется от Stream.)
СвойствоCanWrite Получает значение, определяющее в текущем потоке наличие поддержки операций записи.
СвойствоHandle Возвращает дескриптор файла операционной системы для файла, инкапсулируемого текущим объектом FileStream.
СвойствоIsAsync Получает значение, определяющее, как был открыт FileStream — синхронно или асинхронно.
СвойствоLength Получает длину потока в байтах.
СвойствоName Получает передаваемое в конструктор имя FileStream.
СвойствоPosition Получает или задает текущую позицию этого потока.
СвойствоReadTimeout Получает или задает значение в миллисекундах, определяющее период, в течение которого поток будет пытаться выполнить операцию чтения, прежде чем истечет время ожидания. (Наследуется от Stream.)
СвойствоSafeFileHandle Получает объект SafeFileHandle , который представляет дескриптор файла операционной системы для файла, инкапсулируемого текущим объектом FileStream .
СвойствоWriteTimeout Получает или задает значение в миллисекундах, определяющее период, в течение которого поток будет пытаться выполнить операцию записи, прежде чем истечет время ожидания. (Наследуется от Stream.)

Методы

ТипИмяОписание
МетодBeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Начинает операцию асинхронного чтения. (Попробуйте вместо этого использовать ReadAsync(Byte[], Int32, Int32, CancellationToken) ; см. раздел «Примечания».) (Переопределяет Stream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object).)
МетодBeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Начинает операцию асинхронной записи. (Попробуйте вместо этого использовать WriteAsync(Byte[], Int32, Int32, CancellationToken) ; см. раздел «Примечания».) (Переопределяет Stream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object).)
МетодClose() Закрывает текущий поток и отключает все ресурсы (например, сокеты и файловые дескрипторы), связанные с текущим потоком.Вместо вызова данного метода, убедитесь в том, что поток надлежащим образом ликвидирован. (Наследуется от Stream.)
МетодCopyTo(Stream) Считывает байты из текущего потока и записывает их в другой поток. (Наследуется от Stream.)
МетодCopyTo(Stream, Int32) Считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера. (Наследуется от Stream.)
МетодCopyToAsync(Stream, Int32) Асинхронно считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера. (Наследуется от Stream.)
МетодCopyToAsync(Stream, Int32, CancellationToken) Асинхронно считывает байты из текущего потока и записывает их в другой поток, используя указанный размер буфера и токен отмены. (Наследуется от Stream.)
МетодCopyToAsync(Stream) Асинхронно считывает байты из текущего потока и записывает их в другой поток. (Наследуется от Stream.)
МетодCreateObjRef(Type) Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Наследуется от MarshalByRefObject.)
МетодDispose() Освобождает все ресурсы, используемые объектом Stream . (Наследуется от Stream.)
МетодEndRead(IAsyncResult) Ожидает завершения отложенной асинхронной операции чтения. (Попробуйте вместо этого использовать ReadAsync(Byte[], Int32, Int32, CancellationToken) ; см. раздел «Примечания».) (Переопределяет Stream.EndRead(IAsyncResult).)
МетодEndWrite(IAsyncResult) Завершает асинхронную операцию записи и блокирует до тех пор, пока не будет завершена операция ввода-вывода. (Попробуйте вместо этого использовать WriteAsync(Byte[], Int32, Int32, CancellationToken) ; см. раздел «Примечания».) (Переопределяет Stream.EndWrite(IAsyncResult).)
МетодEquals(Object) Определяет, равен ли заданный объект текущему объекту. (Наследуется от Object.)
МетодFlush(Boolean) Очищает буферы для этого потока и вызывает запись всех буферизованных данных в файл, а также очищает все буферы промежуточных файлов.
МетодFlush() Очищает буферы для этого потока и вызывает запись всех буферизованных данных в файл. (Переопределяет Stream.Flush().)
МетодFlushAsync(CancellationToken) Асинхронно очищает все буферы данного потока, вызывает запись буферизованных данных в базовое устройство и отслеживает запросы отмены. (Переопределяет Stream.FlushAsync(CancellationToken).)
МетодFlushAsync() Асинхронно очищает все буферы для этого потока и вызывает запись всех буферизованных данных в базовое устройство. (Наследуется от Stream.)
МетодGetAccessControl() Получает объект FileSecurity , который инкапсулирует записи списка управления доступом (ACL) для файла, описываемого текущим объектом FileStream .
МетодGetHashCode() Служит хэш-функцией по умолчанию. (Наследуется от Object.)
МетодGetLifetimeService() Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Наследуется от MarshalByRefObject.)
МетодGetType() Возвращает объект Type для текущего экземпляра. (Наследуется от Object.)
МетодInitializeLifetimeService() Возвращает объект обслуживания во время существования для управления политикой времени существования данного экземпляра. (Наследуется от MarshalByRefObject.)
МетодLock(Int64, Int64) Запрещает другим процессам чтение объекта FileStream или запись в этот объект.
МетодRead(Byte[], Int32, Int32) Выполняет чтение блока байтов из потока и запись данных в заданный буфер. (Переопределяет Stream.Read(Byte[], Int32, Int32).)
МетодReadAsync(Byte[], Int32, Int32, CancellationToken) Асинхронно считывает последовательность байтов из текущего потока, перемещает позицию в потоке на число считанных байтов и отслеживает запросы отмены. (Переопределяет Stream.ReadAsync(Byte[], Int32, Int32, CancellationToken).)
МетодReadAsync(Byte[], Int32, Int32) Асинхронно считывает последовательность байтов из текущего потока и перемещает позицию внутри потока на число считанных байтов. (Наследуется от Stream.)
МетодReadByte() Считывает байт из файла и перемещает положение чтения на один байт. (Переопределяет Stream.ReadByte().)
МетодSeek(Int64, SeekOrigin) Устанавливает текущее положение этого потока на заданное значение. (Переопределяет Stream.Seek(Int64, SeekOrigin).)
МетодSetAccessControl(FileSecurity) Применяет записи списка управления доступом (ACL), описанные объектом FileSecurity , к файлу, который описывается текущим объектом FileStream .
МетодSetLength(Int64) Устанавливает длину этого потока на заданное значение. (Переопределяет Stream.SetLength(Int64).)
МетодToString() Возвращает строку, представляющую текущий объект. (Наследуется от Object.)
МетодUnlock(Int64, Int64) Разрешает доступ других процессов ко всему ранее заблокированному файлу или его части.
МетодWrite(Byte[], Int32, Int32) Записывает блок байтов в файловый поток. (Переопределяет Stream.Write(Byte[], Int32, Int32).)
МетодWriteAsync(Byte[], Int32, Int32, CancellationToken) Асинхронно записывает последовательность байтов в текущий поток, перемещает текущую позицию внутри потока на число записанных байтов и отслеживает запросы отмены. (Переопределяет Stream.WriteAsync(Byte[], Int32, Int32, CancellationToken).)
МетодWriteAsync(Byte[], Int32, Int32) Асинхронно записывает последовательность байтов в текущий поток и перемещает текущую позицию внутри потока на число записанных байтов. (Наследуется от Stream.)
МетодWriteByte(Byte) Запись байта в текущую позицию в потоке файла. (Переопределяет Stream.WriteByte(Byte).)
developers/references/system.io.filestream.txt · Последние изменения: 2021/07/22 14:30 (внешнее изменение)