StringReader Class

Definition

Implementa un oggetto TextReader che legge da una stringa.Implements a TextReader that reads from a string.

public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
Inheritance
StringReader
Inheritance
Attributes

Examples

Nell'esempio seguente viene illustrato come leggere un'intera stringa in modo asincrono.The following example shows how to read an entire string asynchronously.

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
'

Remarks

StringReader consente di leggere una stringa in modo sincrono o asincrono.StringReader enables you to read a string synchronously or asynchronously. È possibile leggere un carattere alla volta con il Read o il metodo ReadAsync, una riga alla volta usando il ReadLine o il metodo ReadLineAsync e un'intera stringa usando il ReadToEnd o il metodo ReadToEndAsync.You can read a character at a time with the Read or the ReadAsync method, a line at a time using the ReadLine or the ReadLineAsync method and an entire string using the ReadToEnd or the ReadToEndAsync method.

Note

Questo tipo implementa l'interfaccia IDisposable, ma attualmente non ha risorse da eliminare.This type implements the IDisposable interface, but does not actually have any resources to dispose. Questo significa che non è necessario eliminarlo chiamando direttamente Dispose() o tramite un costrutto del linguaggio, come using (in C#) o Using (in Visual Basic).This means that disposing it by directly calling Dispose() or by using a language construct such as using (in C#) or Using (in Visual Basic) is not necessary.

Nella tabella seguente sono elencati esempi di altre attività di I/O tipiche o correlate.The following table lists examples of other typical or related I/O tasks.

PerTo do this... Vedere l'esempio riportato in questo argomento...See the example in this topic...
Creare un file di testo.Create a text file. Procedura: Scrivere un testo in un fileHow to: Write Text to a File
Scrivere in un file di testo.Write to a text file. Procedura: Scrivere un testo in un fileHow to: Write Text to a File
Leggere da un file di testo.Read from a text file. Procedura: Leggere testo da un fileHow to: Read Text from a File
Aggiungere testo a un file.Append text to a file. Procedura: Aprire e accodare un file di logHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Ottenere le dimensioni di un file.Get the size of a file. FileInfo.Length
Ottenere gli attributi di un file.Get the attributes of a file. File.GetAttributes
Impostare gli attributi di un file.Set the attributes of a file. File.SetAttributes
Determinare se un file esiste.Determine if a file exists. File.Exists
Leggere da un file binario.Read from a binary file. Procedura: Leggere e scrivere su un file di dati appena creatoHow to: Read and Write to a Newly Created Data File
Scrivere in un file binario.Write to a binary file. Procedura: Leggere e scrivere su un file di dati appena creatoHow to: Read and Write to a Newly Created Data File

Constructors

StringReader(String)

Inizializza una nuova istanza della classe StringReader che legge dalla stringa specificata.Initializes a new instance of the StringReader class that reads from the specified string.

Methods

Close()

Chiude l'oggetto StringReader.Closes the StringReader.

Close()

Chiude l'oggetto TextReader e libera tutte le risorse di sistema associate a TextReader.Closes the TextReader and releases any system resources associated with the TextReader.

(Inherited from 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose()

Rilascia tutte le risorse utilizzate dall'oggetto TextReader.Releases all resources used by the TextReader object.

(Inherited from TextReader)
Dispose(Boolean)

Rilascia le risorse non gestite utilizzate dall'oggetto StringReader e facoltativamente le risorse gestite.Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Peek()

Restituisce il carattere successivo disponibile senza usarlo.Returns the next available character but does not consume it.

Read()

Legge il carattere successivo dalla stringa di input e fa avanzare di un carattere la posizione del carattere.Reads the next character from the input string and advances the character position by one character.

Read(Char[], Int32, Int32)

Legge un blocco di caratteri dalla stringa di input e fa avanzare la posizione del carattere di count.Reads a block of characters from the input string and advances the character position by 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.Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

Read(Span<Char>)

Legge i caratteri dal lettore corrente e scrive i dati nel buffer specificato.Reads the characters from the current reader and writes the data to the specified buffer.

(Inherited from 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.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(Inherited from 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.Asynchronously reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

ReadAsync(Memory<Char>, CancellationToken)

Legge in modo asincrono i caratteri dal flusso corrente in un blocco di memoria.Asynchronously reads the characters from the current stream into a memory block.

(Inherited from 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.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

(Inherited from 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.Reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlock(Span<Char>)

Legge i caratteri dal flusso corrente e scrive i dati in un buffer.Reads the characters from the current stream and writes the data to a buffer.

(Inherited from 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.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(Inherited from 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.Asynchronously reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlockAsync(Memory<Char>, CancellationToken)

Legge in modo asincrono i caratteri dal flusso corrente e scrive i dati in un buffer.Asynchronously reads the characters from the current stream and writes the data to a buffer.

(Inherited from TextReader)
ReadLine()

Legge una riga di caratteri dalla stringa corrente e restituisce i dati come stringa.Reads a line of characters from the current string and returns the data as a string.

ReadLineAsync()

Legge una riga di caratteri in modo asincrono dalla stringa corrente e restituisce i dati come stringa.Reads a line of characters asynchronously from the current string and returns the data as a string.

ReadLineAsync()

Legge una riga di caratteri in modo asincrono e restituisce i dati come stringa.Reads a line of characters asynchronously and returns the data as a string.

(Inherited from TextReader)
ReadToEnd()

Legge tutti i caratteri dalla posizione corrente fino alla fine della stringa e li restituisce come singola stringa.Reads all characters from the current position to the end of the string and returns them as a single string.

ReadToEndAsync()

Legge in modo asincrono tutti i caratteri dalla posizione corrente fino alla fine della stringa e li restituisce come singola stringa.Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.

ReadToEndAsync()

Legge in modo asincrono tutti i caratteri dalla posizione corrente fino alla fine del lettore di testo e li restituisce come singola stringa.Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.

(Inherited from TextReader)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

IDisposable.Dispose()

Per una descrizione di questo membro, vedere Dispose().For a description of this member, see Dispose().

(Inherited from TextReader)

Applies to

See also