StringReader Classe

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object

TextReader
StringReader

Ereditarietà: Object

MarshalByRefObject

TextReader
StringReader

Attributi: SerializableAttribute ComVisibleAttribute

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 in 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.
Close()	Chiude l'oggetto TextReader e libera tutte le risorse di sistema associate a `TextReader`. (Ereditato da TextReader)
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()	Obsoleta. 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()	Obsoleta. 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.
Read(Span<Char>)	Legge i caratteri dal lettore corrente e scrive i dati nel buffer specificato. (Ereditato da TextReader)
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(Char[], Int32, Int32)	Legge un numero massimo specificato di caratteri dal lettore di testo corrente in modo asincrono e scrive i dati in un buffer, a partire dall'indice specificato. (Ereditato da TextReader)
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.
ReadAsync(Memory<Char>, CancellationToken)	Legge in modo asincrono i caratteri dal flusso corrente in un blocco di memoria. (Ereditato da TextReader)
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.
ReadBlock(Span<Char>)	Legge i caratteri dal flusso corrente e scrive i dati in un buffer. (Ereditato da TextReader)
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(Char[], Int32, Int32)	Legge un numero massimo specificato di caratteri dal lettore di testo corrente in modo asincrono e scrive i dati in un buffer, a partire dall'indice specificato. (Ereditato da TextReader)
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.
ReadBlockAsync(Memory<Char>, CancellationToken)	Legge in modo asincrono i caratteri dal flusso corrente e scrive i dati in un buffer. (Ereditato da TextReader)
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()	Legge una riga di caratteri in modo asincrono e restituisce i dati come stringa. (Ereditato da TextReader)
ReadLineAsync(CancellationToken)	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 e restituisce i dati come stringa. (Ereditato da TextReader)
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()	Legge in modo asincrono tutti i caratteri dalla posizione corrente fino alla fine del lettore di testo e li restituisce come singola stringa. (Ereditato da TextReader)
ReadToEndAsync(CancellationToken)	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 del lettore di testo e li restituisce come singola stringa. (Ereditato da TextReader)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

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

(Ereditato da TextReader)

Si applica a