StringReader Classe

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Origine:

StringReader.cs

Implementa un oggetto TextReader che legge da una stringa.

public ref class StringReader : System::IO::TextReader

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Ereditarietà

Object

MarshalByRefObject

TextReader

StringReader

Esempio

Nell'esempio seguente viene illustrato come leggere un'intera stringa in modo asincrono.

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            StringBuilder stringToRead = new StringBuilder();
            stringToRead.AppendLine("Characters in 1st line to read");
            stringToRead.AppendLine("and 2nd line");
            stringToRead.AppendLine("and the end");

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                string readText = await reader.ReadToEndAsync();
                Console.WriteLine(readText);
            }
        }
    }
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = New StringBuilder()
        stringToRead.AppendLine("Characters in 1st line to read")
        stringToRead.AppendLine("and 2nd line")
        stringToRead.AppendLine("and the end")

        Using reader As StringReader = New StringReader(stringToRead.ToString())
            Dim readText As String = Await reader.ReadToEndAsync()
            Console.WriteLine(readText)
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

Commenti

StringReader consente di leggere una stringa in modo sincrono o asincrono. È possibile leggere un carattere alla volta con Read il metodo oReadAsync, una riga alla volta usando il metodo o il metodo e un'intera stringa usando ReadLine il ReadToEnd metodo o ReadLineAsync il ReadToEndAsync metodo .

Nota

Questo tipo implementa l'interfaccia IDisposable, ma attualmente non ha risorse da eliminare. Questo significa che non è necessario eliminarlo chiamando direttamente Dispose() o tramite un costrutto del linguaggio, come using (in C#) o Using (in Visual Basic).

Nella tabella seguente sono elencati esempi di altre attività di I/O tipiche o correlate.

Per eseguire questa operazione...	Vedere l'esempio riportato in questo argomento...
Creare un file di testo.	Procedura: Scrivere un testo in un file
Scrivere in un file di testo.	Procedura: Scrivere un testo in un file
Leggere da un file di testo.	Procedura: Leggere testo da un file
Aggiungere testo a un file.	Procedura: Aprire e accodare un file di log File.AppendText FileInfo.AppendText
Ottenere le dimensioni di un file.	FileInfo.Length
Ottenere gli attributi di un file.	File.GetAttributes
Impostare gli attributi di un file.	File.SetAttributes
Determinare se esiste un file.	File.Exists
Leggere da un file binario.	Procedura: Leggere e scrivere su un file di dati appena creato
Scrivere in un file binario.	Procedura: Leggere e scrivere su un file di dati appena creato

Costruttori

StringReader(String)

Inizializza una nuova istanza della classe StringReader che legge dalla stringa specificata.

Metodi

Close()	Chiude l'oggetto StringReader.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate dall'oggetto TextReader. (Ereditato da TextReader)
Dispose(Boolean)	Rilascia le risorse non gestite usate da StringReader e, facoltativamente, le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Peek()	Restituisce il carattere successivo disponibile senza usarlo.
Read()	Legge il carattere successivo dalla stringa di input e fa avanzare di un carattere la posizione del carattere.
Read(Char[], Int32, Int32)	Legge un blocco di caratteri dalla stringa di input e fa avanzare la posizione del carattere di count.
Read(Span<Char>)	Legge tutti i caratteri dalla stringa di input, a partire dalla posizione corrente e fa avanzare la posizione corrente fino alla fine della stringa di input.
ReadAsync(Char[], Int32, Int32)	Legge in modo asincrono un numero massimo specificato di caratteri dalla stringa corrente e scrive i dati in un buffer, a partire dall'indice specificato.
ReadAsync(Memory<Char>, CancellationToken)	Legge in modo asincrono tutti i caratteri dalla stringa di input, a partire dalla posizione corrente e fa avanzare la posizione corrente fino alla fine della stringa di input.
ReadBlock(Char[], Int32, Int32)	Legge un numero massimo specificato di caratteri dal lettore di testo corrente e scrive i dati in un buffer, a partire dall'indice specificato. (Ereditato da TextReader)
ReadBlock(Span<Char>)	Legge tutti i caratteri dalla stringa di input a partire dalla posizione corrente e fa avanzare la posizione corrente fino alla fine della stringa di input.
ReadBlockAsync(Char[], Int32, Int32)	Legge in modo asincrono un numero massimo specificato di caratteri dalla stringa corrente e scrive i dati in un buffer, a partire dall'indice specificato.
ReadBlockAsync(Memory<Char>, CancellationToken)	Legge in modo asincrono tutti i caratteri dalla stringa di input a partire dalla posizione corrente e fa avanzare la posizione corrente fino alla fine della stringa di input.
ReadLine()	Legge una riga di caratteri dalla stringa corrente e restituisce i dati come stringa.
ReadLineAsync()	Legge una riga di caratteri in modo asincrono dalla stringa corrente e restituisce i dati come stringa.
ReadLineAsync(CancellationToken)	Legge una riga di caratteri in modo asincrono dalla stringa corrente e restituisce i dati come stringa.
ReadToEnd()	Legge tutti i caratteri dalla posizione corrente fino alla fine della stringa e li restituisce come singola stringa.
ReadToEndAsync()	Legge in modo asincrono tutti i caratteri dalla posizione corrente fino alla fine della stringa e li restituisce come singola stringa.
ReadToEndAsync(CancellationToken)	Legge in modo asincrono tutti i caratteri dalla posizione corrente fino alla fine della stringa e li restituisce come singola stringa.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• TextReader
• StringWriter
• File e Stream I/O
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file