StreamReader Classe

Definizione

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

Ereditarietà

Object

TextReader

StreamReader

Ereditarietà

Object

MarshalByRefObject

TextReader

StreamReader

Attributi

SerializableAttribute ComVisibleAttribute

Esempio

Nell'esempio seguente viene utilizzata un'istanza di StreamReader per leggere testo da un file. Il costruttore usato in questo esempio non è supportato per l'uso nelle app di 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

Nell'esempio seguente viene creata un'istanza di un StreamReader oggetto e viene chiamato il ReadAsync relativo metodo per leggere un file in modo asincrono.

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.

Commenti

StreamReader è progettato per l'input di caratteri in una particolare codifica, mentre la classe è progettata per l'input e l'output Stream dei byte. Utilizzare StreamReader per leggere le righe di informazioni da un file di testo standard.

StreamReader per impostazione predefinita, la codifica UTF-8 viene impostata su UTF-8, a meno che non venga specificata diversamente, anziché la tabella codici ANSI per il sistema corrente. UTF-8 gestisce correttamente i caratteri Unicode e fornisce risultati coerenti sulle versioni localizzate del sistema operativo. Se si ottiene la codifica dei caratteri corrente usando la CurrentEncoding proprietà , il valore non è affidabile fino a quando il primo Read metodo non viene eseguito, poiché il rilevamento automatico della codifica non viene eseguito fino alla prima chiamata a un Read metodo.

Per impostazione predefinita, un oggetto StreamReader non è thread-safe. Vedere TextReader.Synchronized per un wrapper thread-safe.

L'overload del Read(Char[], Int32, Int32) metodo e Write(Char[], Int32, Int32) legge e scrive il numero di caratteri specificato dal count parametro . Devono essere distinti da BufferedStream.Read e BufferedStream.Write, che leggono e scrivono il numero di byte specificati dal count parametro . Utilizzare i BufferedStream metodi solo per la lettura e la scrittura di un numero integrale di elementi della matrice di byte.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

• Encoding
• Stream
• StreamWriter
• I/O di file e di flussi
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file
• Procedura: Leggere e scrivere in un file di dati appena creato