StringReader Classe

Definizione

Implementa un oggetto TextReader che legge da una stringa.

public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
[<System.Serializable>]
type StringReader = class
    inherit TextReader
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
Ereditarietà
StringReader
Ereditarietà
Attributi

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 o Read il ReadAsync metodo , una riga alla volta usando il ReadLine metodo o il ReadLineAsync metodo e un'intera stringa usando il ReadToEnd metodo o .ReadToEndAsync

Note

Questo tipo implementa l'interfaccia IDisposable , ma non ha effettivamente risorse da eliminare. Ciò significa che la eliminazione viene eseguita chiamando direttamente Dispose() o usando un costrutto del linguaggio, ad esempio using (in C#) o Using (in Visual Basic) non è necessario.

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

Per eseguire questa operazione... Consulta l'esempio in questo argomento...
Creare un file di testo. Procedura: Scrivere testo in un file
Scrittura in un file di testo. Procedura: Scrivere testo in un file
Leggere da un file di testo. Procedura: Leggere testo da un file
Aggiungere testo a un file. Procedura: Aprire e aggiungere a 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 in un file di dati appena creato
Scrivere in un file binario. Procedura: Leggere e scrivere in un file di dati appena creato

Costruttori

Nome Descrizione
StringReader(String)

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

Metodi

Nome Descrizione
Close()

Chiude l'oggetto StringReader.

CreateObjRef(Type)

Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse utilizzate dall'oggetto TextReader .

(Ereditato da TextReader)
Dispose(Boolean)

Rilascia le risorse non gestite usate da StringReader e, facoltativamente, rilascia 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()

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto corrente MarshalByRefObject .

(Ereditato da MarshalByRefObject)
Peek()

Restituisce il carattere disponibile successivo, ma non lo utilizza.

Read()

Legge il carattere successivo dalla stringa di input e sposta in avanti la posizione del carattere di un carattere.

Read(Char[], Int32, Int32)

Legge un blocco di caratteri dalla stringa di input e sposta in avanti la posizione del carattere in countbase a .

Read(Span<Char>)

Legge tutti i caratteri dalla stringa di input, a partire dalla posizione corrente e sposta la posizione corrente alla fine della stringa di input.

ReadAsync(Char[], Int32, Int32)

Legge un numero massimo di caratteri specificato dalla stringa corrente in modo asincrono 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 sposta la posizione corrente 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 sposta la posizione corrente alla fine della stringa di input.

ReadBlockAsync(Char[], Int32, Int32)

Legge un numero massimo di caratteri specificato dalla stringa corrente in modo asincrono 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 sposta la posizione corrente 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.

ReadToEnd()

Legge tutti i caratteri dalla posizione corrente alla fine della stringa e li restituisce come singola stringa.

ReadToEndAsync()

Legge tutti i caratteri dalla posizione corrente alla fine della stringa in modo asincrono e li restituisce come singola stringa.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IDisposable.Dispose()

Per una descrizione di questo membro, vedere Dispose().

(Ereditato da TextReader)

Si applica a

Vedi anche