TextReader.Read Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Legge dati dal lettore di testo.

Overload

Read()	Legge il carattere successivo dal lettore di testo e fa avanzare di un carattere la posizione del carattere.
Read(Span<Char>)	Legge i caratteri dal lettore corrente e scrive i dati nel buffer specificato.
Read(Char[], Int32, Int32)	Legge un numero massimo specificato di caratteri dal lettore corrente e scrive i dati in un buffer, a partire dall'indice specificato.

Read()

Origine:

TextReader.cs

Legge il carattere successivo dal lettore di testo e fa avanzare di un carattere la posizione del carattere.

public:
 virtual int Read();

public virtual int Read ();

abstract member Read : unit -> int
override this.Read : unit -> int

Public Overridable Function Read () As Integer

Restituisce

Int32

Carattere successivo del lettore di testo oppure -1 se non sono disponibili altri caratteri. L'implementazione predefinita restituisce -1.

Eccezioni

ObjectDisposedException

TextReader è chiuso.

IOException

Si è verificato un errore di I/O.

Commenti

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

Vedi anche

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

Read(Span<Char>)

Origine:

TextReader.cs

Legge i caratteri dal lettore corrente e scrive i dati nel buffer specificato.

public:
 virtual int Read(Span<char> buffer);

public virtual int Read (Span<char> buffer);

abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int

Public Overridable Function Read (buffer As Span(Of Char)) As Integer

Parametri

buffer

Span<Char>

Al termine di questo metodo, contiene l'intervallo di caratteri specificato sostituiti con i caratteri letti dall'origine corrente.

Restituisce

Int32

Numero di caratteri letti. Il numero sarà minore o uguale alla lunghezza del buffer, a seconda che i dati siano disponibili all'interno del lettore o meno. Se viene chiamato quando non sono più disponibili altri caratteri da leggere, questo metodo restituirà zero.

Eccezioni

ArgumentNullException

buffer è null.

IOException

Il numero di caratteri letti dal flusso è maggiore della lunghezza del buffer.

Read(Char[], Int32, Int32)

Origine:

TextReader.cs

Legge un numero massimo specificato di caratteri dal lettore corrente e scrive i dati in un buffer, a partire dall'indice specificato.

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);

public virtual int Read (char[] buffer, int index, int count);

abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int

Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Parametri

buffer

Char[]

Quando questo metodo viene restituito, contiene la matrice di caratteri specificata con i valori compresi tra index e (index + + count - 1) sostituiti con i caratteri letti dall'origine corrente.

index

Int32

Posizione in buffer da cui iniziare la scrittura.

count

Int32

Numero massimo di caratteri da leggere. Se viene raggiunta la fine del reader prima che il numero di caratteri specificato venga letto nel buffer, il metodo restituisce un risultato.

Restituisce

Int32

Numero di caratteri letti. Il numero sarà minore o uguale a count, a seconda che i dati siano disponibili all'interno del lettore o meno. Se viene chiamato quando non sono più disponibili altri caratteri da leggere, questo metodo restituirà zero.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentException

La lunghezza del buffer meno index è minore di count.

ArgumentOutOfRangeException

index o count è negativo.

ObjectDisposedException

TextReader è chiuso.

IOException

Si è verificato un errore di I/O.

Commenti

Questo metodo viene restituito dopo la count lettura dei caratteri o la fine del file. ReadBlock è una versione di blocco di questo metodo.

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

Vedi anche

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• I/O di file e Stream
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file