TextReader.Read TextReader.Read TextReader.Read TextReader.Read Method

Definizione

Legge dati dal lettore di testo.Reads data from the text reader.

Overload

Read() Read() Read() Read()

Legge il carattere successivo dal lettore di testo e fa avanzare di un carattere la posizione del carattere.Reads the next character from the text reader and advances the character position by one character.

Read(Span<Char>) Read(Span<Char>) Read(Span<Char>) Read(Span<Char>)
Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) 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.Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.

Read() Read() Read() Read()

Legge il carattere successivo dal lettore di testo e fa avanzare di un carattere la posizione del carattere.Reads the next character from the text reader and advances the character position by one character.

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.The next character from the text reader, or -1 if no more characters are available. L'implementazione predefinita restituisce -1.The default implementation returns -1.

Eccezioni

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

La classe TextReader è una classe astratta.The TextReader class is an abstract class. Di conseguenza, non verrà creata un'istanza nel codice.Therefore, you do not instantiate it in your code. Per un esempio d'uso di Read metodo, vedere il StreamReader.Read (metodo).For an example of using the Read method, see the StreamReader.Read method.

Vedi anche

Read(Span<Char>) Read(Span<Char>) Read(Span<Char>) Read(Span<Char>)

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>

Restituisce

Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) Read(Char[], Int32, Int32) 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.Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.

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.When this method returns, contains the specified character array with the values between index and (index + count - 1) replaced by the characters read from the current source.

index
Int32 Int32 Int32 Int32

Posizione in buffer da cui iniziare la scrittura.The position in buffer at which to begin writing.

count
Int32 Int32 Int32 Int32

Numero massimo di caratteri da leggere.The maximum number of characters to read. Se viene raggiunta la fine del reader prima che il numero di caratteri specificato venga letto nel buffer, il metodo restituisce un risultato.If the end of the reader is reached before the specified number of characters is read into the buffer, the method returns.

Restituisce

Numero di caratteri letti.The number of characters that have been read. Il numero sarà minore o uguale a count, a seconda che i dati siano disponibili all'interno del lettore o meno.The number will be less than or equal to count, depending on whether the data is available within the reader. Se viene chiamato quando non sono più disponibili altri caratteri da leggere, questo metodo restituirà zero.This method returns 0 (zero) if it is called when no more characters are left to read.

Eccezioni

La lunghezza del buffer meno index è minore di count.The buffer length minus index is less than count.

Si è verificato un errore di I/O.An I/O error occurs.

Commenti

Questo metodo restituisce dopo che count caratteri vengono letti o viene raggiunta la fine del file.This method returns after either count characters are read or the end of the file is reached. ReadBlock è una versione di blocco di questo metodo.is a blocking version of this method.

La classe TextReader è una classe astratta.The TextReader class is an abstract class. Di conseguenza, non verrà creata un'istanza nel codice.Therefore, you do not instantiate it in your code. Per un esempio d'uso di Read metodo, vedere il StreamReader.Read (metodo).For an example of using the Read method, see the StreamReader.Read method.

Vedi anche

Si applica a