TextReader.Read Metodo

Definizione

Spazio dei nomi:
System.IO
Assembly:
mscorlib.dll, System.IO.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.dll
Assembly:
netstandard.dll

Legge i dati dal lettore di testo.

Overload

Nome Descrizione
Read()

Legge il carattere successivo dal lettore di testo e sposta in avanti la posizione del carattere di un 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 di caratteri specificato dal lettore corrente e scrive i dati in un buffer, a partire dall'indice specificato.

Read()

Legge il carattere successivo dal lettore di testo e sposta in avanti la posizione del carattere di un 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

Valori restituiti

Int32

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

Eccezioni

ObjectDisposedException

L'oggetto TextReader è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

La TextReader classe è una classe astratta. Di conseguenza, non è necessario crearne 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>)

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>

Quando termina, questo metodo contiene l'intervallo specificato di caratteri sostituiti dai caratteri letti dall'origine corrente.

Valori restituiti

Int32

Numero di caratteri letti. Il numero sarà minore o uguale alla buffer lunghezza, a seconda che i dati siano disponibili all'interno del lettore. Questo metodo restituisce 0 (zero) se viene chiamato quando non vengono lasciati più caratteri da leggere.

Eccezioni

ArgumentNullException

buffer è null.

IOException

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

Si applica a

Read(Char[], Int32, Int32)

Legge un numero massimo di caratteri specificato 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 termina, questo metodo contiene la matrice di caratteri specificata con i valori compresi tra index e (index + count - 1) sostituiti dai caratteri letti dall'origine corrente.

index
Int32

Posizione in in buffer cui iniziare la scrittura.

count
Int32

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

Valori restituiti

Int32

Numero di caratteri letti. Il numero sarà minore o uguale a count, a seconda che i dati siano disponibili all'interno del lettore. Questo metodo restituisce 0 (zero) se viene chiamato quando non vengono lasciati più caratteri da leggere.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentException

La lunghezza del buffer meno index è minore di count.

ArgumentOutOfRangeException

index o count è negativo.

ObjectDisposedException

L'oggetto TextReader è chiuso.

IOException

Si verifica un errore di I/O.

Commenti

Questo metodo viene restituito dopo che i count caratteri vengono letti o viene raggiunta la fine del file. ReadBlock è una versione di blocco di questo metodo.

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

Vedi anche

Si applica a