TextReader.ReadToEnd Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Origine:

TextReader.cs

Legge tutti i caratteri dalla posizione corrente fino alla fine del lettore di testo e li restituisce come singola stringa.

public:
 virtual System::String ^ ReadToEnd();

public virtual string ReadToEnd ();

abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> string

Public Overridable Function ReadToEnd () As String

Restituisce

String

Stringa contenente tutti i caratteri dalla posizione corrente fino alla fine del lettore di testo.

Eccezioni

IOException

Si è verificato un errore di I/O.

ObjectDisposedException

TextReader è chiuso.

OutOfMemoryException

La memoria disponibile non è sufficiente per l’allocazione di un buffer per la stringa restituita.

ArgumentOutOfRangeException

Il numero di caratteri nella riga successiva è maggiore di Int32.MaxValue

Commenti

Se il metodo genera un'eccezione OutOfMemoryException , la posizione del lettore nell'oggetto sottostante Stream è avanzata dal numero di caratteri che il metodo è stato in grado di leggere, ma i caratteri già letti nel buffer interno ReadToEnd vengono eliminati. Poiché la posizione del lettore nel flusso non può essere modificata, i caratteri già letti non sono recuperabili e possono essere accessibili solo reinizializzando .TextReader Se la posizione iniziale all'interno del flusso è sconosciuta o il flusso non supporta la ricerca, è necessario reinizializzare anche l'oggetto sottostante Stream .

Per evitare una situazione di questo tipo e produrre codice affidabile, è consigliabile usare il Read metodo e archiviare i caratteri letti in un buffer preallocato.

La classe TextReader è astratta. Di conseguenza, non verrà creata un'istanza nel codice. Per un esempio di utilizzo del ReadToEnd metodo , vedere il StreamReader.ReadToEnd metodo .

Vedi anche

• ReadToEnd()
• ReadToEnd()
• I/O di file e flusso
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file