StringReader StringReader StringReader StringReader Class

Definizione

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

public ref 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
Ereditarietà
Attributi

Esempi

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
'

Commenti

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

Nota

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.

Per eseguire questa operazione...To 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

Costruttori

StringReader(String) StringReader(String) StringReader(String) 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.

Metodi

Close() Close() Close() Close()

Chiude l'oggetto StringReader.Closes the StringReader.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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() Dispose() Dispose() Dispose()

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

(Inherited from TextReader)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da StringReader e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) 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() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
Peek() Peek() Peek() Peek()

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

Read() Read() Read() 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) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) 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>) Read(Span<Char>) Read(Span<Char>) Read(Span<Char>)
ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) 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(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken)
ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) ReadBlock(Char[], Int32, Int32) 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>) ReadBlock(Span<Char>) ReadBlock(Span<Char>) ReadBlock(Span<Char>)
ReadBlockAsync(Char[], Int32, Int32) ReadBlockAsync(Char[], Int32, Int32) ReadBlockAsync(Char[], Int32, Int32) 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(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken) ReadBlockAsync(Memory<Char>, CancellationToken)
ReadLine() ReadLine() ReadLine() 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() ReadLineAsync() ReadLineAsync() 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.

ReadToEnd() ReadToEnd() ReadToEnd() 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() ReadToEndAsync() ReadToEndAsync() 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.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

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

(Inherited from TextReader)

Si applica a

Vedi anche