Condividi tramite


TextReader.Read Metodo

Definizione

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
Origine:
TextReader.cs
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

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

Eccezioni

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

Si applica a

Read(Span<Char>)

Origine:
TextReader.cs
Origine:
TextReader.cs
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

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

buffer è null.

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

Si applica a

Read(Char[], Int32, Int32)

Origine:
TextReader.cs
Origine:
TextReader.cs
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

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

buffer è null.

La lunghezza del buffer meno index è minore di count.

index o count è negativo.

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

Si applica a