FileShare (общий доступ к файлу) | None (нет), Read (чтение), ReadWrite (чтение-запись), Write (запись) |
Отметим, что в случае FileMode могут порождаться исключения, если запросить режим, который несогласован с существующим статусом файла. Append, Open и Truncate будут порождать исключение, если файл еще не существует, a CreateNew будет порождать исключение, если он существует. Create и OpenOrCreate будут удовлетворять любому сценарию, но Create будет удалять любой существующий файл для замены его новым, вначале пустым файлом.
Существует большое число конструкторов для FileSream. Три простейшие из них работают следующим образом:
// создает файл с доступом read-write и предоставляет другим потокам
// доступ на чтение
FileStream fs = new FileStream(@'C:C# ProjectsProjects.doc', FileMode.Create);
// как и выше, но мы получаем доступ к файлу только на запись
FileStream fs2 = new FileStream(@'C:C# ProjectsProjects2.doc', FileMode.Create, FileAccess.Write);
// как и выше, но другие потоки не имеют никакого доступа к файлу,
// пока fs3 открыт
FileStream fs3 = new FileStream(@'C:C# ProjectsProjects3.doc', FileMode.Create, FileAccess.Read, FileShare.None);
Из этого кода можно видеть, что эти перегружаемые версии конструкторов предоставляют значения по умолчанию FileAcces.ReadWrite и FileShare.Read для третьего и четвертого параметров. Также можно создать файловый поток из экземпляра FileInfo:
FileInfo MyFile4 = new FileInfo(@'C:C# ProjectsProjects4.doc');
FileStream fs4 = MyFile4.OpenRead();
FileInfo MyFile5 = new FileInfo(@'C:C# ProjectsProjects5.doc');
FileStream fs5 = MyFile5.OpenWrite();
FileInfo MyFile6 = new FileInfo(@'C:C# ProjectsProjects6.doc');
FileStream fs6 = MyFile6.Open(FileMode.Append, FileAccess.Read, FileShare.None);
FileInfo MyNewFile = new FileInfo(@'C:C# ProjectsProjectsNew.doc');
FileStream fs7 = MyNewFile.Create();
FileInfo.OpenRead() поставляет поток, предоставляющий доступ только для чтения к существующему файлу, в то время как FileInfo.OpenWrite() предоставляет доступ для чтения-записи. FileInfo.Open() позволяет явно определить параметры режима, доступа и общего доступа.
Не забудьте, что по окончании работы поток необходимо закрыть:
fs.Close();
Закрытие потока освобождает связанные с ним ресурсы и позволяет другим приложениям настроить потоки на тот же самый файл. Для чтения и записи данных в поток FileStream реализует ряд методов.
Метод ReadByte() является простейшим способом чтения данных: он захватывает один байт из потока и преобразовывает результат в int, имеющее значение между 0 и 255. По достижении конца потока возвращается -1:
int NextByte = fs.ReadByte();
Если желательно прочитать несколько байтов за один раз, можно вызвать метод Read() , который читает указанное число байтов в массиве. Read() возвращает реально прочитанное число байтов, если это значение равно нулю, то это говорит о конце потока:
// считать 100 байтов int nBytes = 100;
byte [] ByteArray = new byte[nBytes];
int nBytesRead = fs.Read(ByteArray, 0, nBytes);
Второй параметр в методе Read() — смещение, которое указывает операции Read начать заполнение массива с элемента, отличного от первого.
Если требуется записать данные в файл, то существует два параллельных метода WriteByte () и Write(). WriteByte() записывает один байт в поток:
byte Next Byte = 100; fs.WriteByte(NextByte);
Write(), с другой стороны, записывает массив байтов:
// чтобы записать 100 байтов
int nBytes = 100;
byte [] ByteArray = new byte[nBytes];
// здесь массив заполняется значениями, которые надо записать
fs.Write(BуteArray, 0, nBytes);
Как и для метода Read(), второй параметр позволяет начать записывать с некоторого места, отличного от начала массива. Оба метода WriteByte() и Write() возвращают void.
Помимо этих методов FileStream реализует также другие методы и свойства для выполнения задач учета, типа определения числа байтов в потоке, блокирования потока или очистки буфера. Эти методы обычно не требуются для базового чтения и записи, а если они потребуются, все детали находятся в документации MSDN.
Пример: объект чтения двоичного файла
Для иллюстрации использования класса FileStream напишем пример BinaryFileReader, который считывает и выводит любой файл. Он создается в Visual Studio.NET как оконное приложение. Добавляем один пункт меню, который выводит стандартный диалог OpenFileDialog, запрашивающий файл для чтения, а затем выводит файл. Так как мы читаем двоичные файлы, нам необходимо иметь возможность выводить непечатные символы. Делаем это, выводя каждый байт файла отдельно, по 16 байтов в каждой строке многострочного текстового поля. Если байт представляет печатный символ ASCII, выводится этот символ, иначе выводится значение байта в шестнадцатеричном формате. В любом случае, мы дополняем выводимый текст пробелами, так что каждый выводимый 'байт' занимает четыре столбца, чтобы байты аккуратно выровнялись друг под другом.
Вот как выглядит работа BinaryFileReader при просмотре текстового файла (так как BinaryFileReader может просматривать любой файл, вполне возможно использовать его для текстовых файлов так же, как и для двоичных.) В этом случае пример считывает файл, содержащий переговоры, которые происходили в известной игре 'Цивилизация'.
Очевидно, что этот формат больше подходит для просмотра значений отдельных байтов, а не для вывода текста. Позже в этой главе будет дан пример, специально созданный для чтения текстовых файлов, тогда можно будет увидеть содержимое такого файла. С другой стороны, преимущество этого примера состоит в том, что мы можем увидеть содержимое любого файла.
Для этого примера запись в файлы не показана. Это связано с тем, что мы не хотим увязнуть в
