StreamReader Класс

Определение

public ref class StreamReader : System::IO::TextReader

public class StreamReader : System.IO.TextReader

[System.Serializable]
public class StreamReader : System.IO.TextReader

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StreamReader : System.IO.TextReader

type StreamReader = class
    inherit TextReader

[<System.Serializable>]
type StreamReader = class
    inherit TextReader

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StreamReader = class
    inherit TextReader

Public Class StreamReader
Inherits TextReader

Наследование

Object

TextReader

StreamReader

Наследование

Object

MarshalByRefObject

TextReader

StreamReader

Атрибуты

SerializableAttribute ComVisibleAttribute

Примеры

В следующем примере для чтения текста из файла используется экземпляр StreamReader . Конструктор, используемый в этом примере, не поддерживается для использования в приложениях Магазина Windows.

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      // Create an instance of StreamReader to read from a file.
      StreamReader^ sr = gcnew StreamReader( "TestFile.txt" );
      try
      {
         String^ line;
         
         // Read and display lines from the file until the end of 
         // the file is reached.
         while ( line = sr->ReadLine() )
         {
            Console::WriteLine( line );
         }
      }
      finally
      {
         if ( sr )
            delete (IDisposable^)sr;
      }
   }
   catch ( Exception^ e ) 
   {
      // Let the user know what went wrong.
      Console::WriteLine( "The file could not be read:" );
      Console::WriteLine( e->Message );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            // Create an instance of StreamReader to read from a file.
            // The using statement also closes the StreamReader.
            using (StreamReader sr = new StreamReader("TestFile.txt"))
            {
                string line;
                // Read and display lines from the file until the end of
                // the file is reached.
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
        catch (Exception e)
        {
            // Let the user know what went wrong.
            Console.WriteLine("The file could not be read:");
            Console.WriteLine(e.Message);
        }
    }
}

Imports System.IO

Class Test
    Public Shared Sub Main()
        Try
            ' Create an instance of StreamReader to read from a file.
            Dim sr As StreamReader = New StreamReader("TestFile.txt")
            Dim line As String
            ' Read and display the lines from the file until the end 
            ' of the file is reached.
            Do
                line = sr.ReadLine()
                Console.WriteLine(Line)
            Loop Until line Is Nothing
            sr.Close()
        Catch E As Exception
            ' Let the user know what went wrong.
            Console.WriteLine("The file could not be read:")
            Console.WriteLine(E.Message)
        End Try
    End Sub
End Class

В следующем примере создается StreamReader экземпляр объекта и вызывается его ReadAsync метод для асинхронного чтения файла.

using System;
using System.IO;
using System.Threading.Tasks;

class Example
{
    static async Task Main()
    {
        await ReadAndDisplayFilesAsync();
    }

    static async Task ReadAndDisplayFilesAsync()
    {
        String filename = "TestFile1.txt";
        Char[] buffer;

        using (var sr = new StreamReader(filename)) {
            buffer = new Char[(int)sr.BaseStream.Length];
            await sr.ReadAsync(buffer, 0, (int)sr.BaseStream.Length);
        }

        Console.WriteLine(new String(buffer));
    }
}
// The example displays the following output:
//       This is the first line of text in a relatively short file.
//       This is the second line.
//       This is the third line.
//       This is the fourth and final line.

Imports System.IO
Imports System.Threading.Tasks

Module Example
    Public Sub Main()
        ReadAndDisplayFilesAsync()
    End Sub

    Private Async Sub ReadAndDisplayFilesAsync()
        Dim filename As String = "TestFile1.txt"
        Dim buffer() As Char
        
        Using sr As New StreamReader(filename)
            ReDim buffer(CInt(sr.BaseStream.Length))
            Await sr.ReadAsync(buffer, 0, CInt(sr.BaseStream.Length))
        End Using

        Console.WriteLine(New String(buffer))
    End Sub
End Module
' The example displays the following output:
'       This is the first line of text in a relatively short file.
'       This is the second line.
'       This is the third line.
'       This is the fourth and final line.

Комментарии

StreamReader предназначен для ввода символов в определенной кодировке Stream , а класс предназначен для ввода и вывода байтов. Используется StreamReader для чтения строк данных из стандартного текстового файла.

StreamReader по умолчанию используется кодировка UTF-8, если не указано иное, а не кодовая страница ANSI для текущей системы. UTF-8 правильно обрабатывает символы Юникода и обеспечивает согласованные результаты в локализованных версиях операционной системы. Если вы получите текущую кодировку CurrentEncoding символов с помощью свойства , значение будет надежным только после первого Read метода, так как автоматическое обнаружение кодирования не выполняется до первого вызова Read метода.

По умолчанию не является потокобезопасной StreamReader . См. TextReader.Synchronized сведения о потокобезопасной оболочке.

Метод Read(Char[], Int32, Int32) и Write(Char[], Int32, Int32) перегружает чтение и запись количества символов, заданного параметром count . Их следует отличать от BufferedStream.Read и BufferedStream.Write, которые считывают и записывают количество байтов, заданное параметром count . BufferedStream Используйте методы только для чтения и записи целого числа элементов массива байтов.

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

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

Поля

Свойства

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

• Encoding
• Stream
• StreamWriter
• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл
• Практическое руководство. Считывание данных из нового файла и запись в этот файл