C# 4.0: полное руководство

где путь — это имя открываемого файла, включая полный путь к нему. Если во второй форме этого конструктора значение параметра append равно true, то выводимые данные присоединяются в конец существующего файла. В противном случае эти данные перезаписывают содержимое указанного файла. Но независимо от формы конструктора файл создается, если он не существует. При появлении ошибок ввода-вывода в обоих случаях генерируется исключение IOException. Кроме того, могут быть сгенерированы и другие исключения.

Ниже приведен вариант представленной ранее сервисной программы ввода с клавиатуры и вывода на диск, измененный таким образом, чтобы открывать выходной файл средствами самого класса StreamWriter.

// Открыть файл средствами класса StreamWriter.

using System;

using System.IO;

class KtoD {

  static void Main() {

    string str;

    StreamWriter fstr_out = null;

    try {

      // Открыть файл, заключенный в оболочку класса StreamWriter.

      fstr_out = new StreamWriter("test.txt");

      Console.WriteLine("Введите текст, а по окончании — 'стоп'.");

      do {

        Console.Write (": ");

        str = Console.ReadLine();

        if(str != "стоп") {

          str = str + "\r\n"; // добавить новую строку

          fstr_out.Write(str);

        }

      } while(str != "стоп");

    } catch(IOException exc) {

      Console.WriteLine("Ошибка ввода-вывода:\n" + exc.Message);

    } finally {

      if(fstr_out != null) fstr_out.Close() ;

    }

  }

}

Применение класса StreamReader

Для создания символьного потока ввода достаточно заключить байтовый поток в оболочку класса StreamReader. В классе StreamReader определено несколько конструкторов. Ниже приведен наиболее часто используемый конструктор:

StreamReader(Stream поток)

где поток обозначает имя открытого потока. Этот конструктор генерирует исключение ArgumentNullException, если поток оказывается пустым, а также исключение ArgumentException, если поток не открыт для ввода. После своего создания объект класса StreamReader выполняет автоматическое преобразование байтов в символы. По завершении ввода из потока типа StreamReader его нужно закрыть. При этом закрывается и базовый поток.

В приведенном ниже примере создается простая сервисная программа ввода с диска и вывода на экран содержимого текстового файла test.txt. Она служит дополнением к представленной ранее сервисной программе ввода с клавиатуры и вывода на диск.

// Простая сервисная программа ввода с диска и вывода на экран,

// демонстрирующая применение класса StreamReader.

using System;

using System.IO;

class DtoS {

  static void Main() {

    FileStream fin;

    string s;

    try {

      fin = new FileStream("test.txt", FileMode.Open);

    }

    catch(IOException exc) {

      Console.WriteLine("Ошибка открытия файла:" + exc.Message);

      return;

    }

    StreamReader fstr_in = new StreamReader(fin);

    try {

      while((s = fstr_in.ReadLine()) != null) {

        Console.WriteLine(s);

      }

    } catch(IOException exc) {

      Console.WriteLine("Ошибка ввода-вывода:\n" + exc.Message);

    } finally {

      fstr_in.Close();

    }

  }

}

Обратите внимание на то, как в этой программе определяется конец файла. Когда метод ReadLine() возвращает пустую ссылку, это означает, что достигнут конец файла. Такой способ вполне работоспособен, но в классе StreamReader предоставляется еще одно средство для обнаружения конца потока — EndOfStream. Это доступное для чтения свойство имеет логическое значение true, когда достигается конец потока, в противном случае — логическое значение false. Следовательно, свойство EndOfStream можно использовать для отслеживания конца файла. В качестве примера ниже представлен другой способ организации цикла while для чтения из файла.

while(!fstr_in.EndOfStream) {

  s = fstr_in.ReadLine();

  Console.WriteLine(s);

}