StreamReader Classe

Definição

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

Herança

Object

TextReader

StreamReader

Herança

Object

MarshalByRefObject

TextReader

StreamReader

Atributos

SerializableAttribute ComVisibleAttribute

Exemplos

O exemplo seguinte utiliza uma instância de StreamReader para ler texto de um ficheiro. O construtor usado neste exemplo não é suportado para uso em aplicações da Windows Store.

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

O exemplo seguinte instancia um StreamReader objeto e chama o seu ReadAsync método para ler um ficheiro de forma assíncrona.

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.

Observações

StreamReader é concebido para entrada de caracteres numa codificação específica, enquanto a Stream classe é concebida para entrada e saída por bytes. Usar StreamReader para ler linhas de informação de um ficheiro de texto padrão.

StreamReader por defeito é a codificação UTF-8, salvo indicação em contrário, em vez de usar por defeito a página de códigos ANSI do sistema atual. O UTF-8 lida corretamente com caracteres Unicode e fornece resultados consistentes em versões localizadas do sistema operativo. Se obtiver a codificação atual de caracteres usando a CurrentEncoding propriedade, o valor não é fiável até depois do primeiro Read método, uma vez que a deteção automática da codificação só é feita na primeira chamada a um Read método.

Por defeito, a StreamReader não é seguro para threads. Procura TextReader.Synchronized um invólucro seguro para fios.

O Read(Char[], Int32, Int32) método and Write(Char[], Int32, Int32) sobrecarrega a leitura e escrita o número de caracteres especificados pelo count parâmetro. Estes devem ser distinguidos de BufferedStream.Read e BufferedStream.Write, que leem e escrevem o número de bytes especificados pelo count parâmetro. Use os BufferedStream métodos apenas para ler e escrever um número inteiro de elementos do array de bytes.

Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

• Encoding
• Stream
• StreamWriter
• E/S de arquivo e fluxo
• Como: Ler texto de um arquivo
• Como: Gravar texto em um arquivo
• Como: Ler e gravar em um arquivo de dados recém-criado