TextReader.ReadAsync TextReader.ReadAsync TextReader.ReadAsync TextReader.ReadAsync Method

Definizione

Overload

ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32)

Legge un numero massimo specificato di caratteri dal lettore di testo corrente in modo asincrono e scrive i dati in un buffer, a partire dall'indice specificato.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken)

ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32) ReadAsync(Char[], Int32, Int32)

Legge un numero massimo specificato di caratteri dal lettore di testo corrente in modo asincrono e scrive i dati in un buffer, a partire dall'indice specificato.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

public:
 virtual System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <char> ^ buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task<int> ReadAsync (char[] buffer, int index, int count);
abstract member ReadAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
Public Overridable Function ReadAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of 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 testo prima che il numero di caratteri specificato venga letto nel buffer, il metodo corrente terminerà.If the end of the text is reached before the specified number of characters is read into the buffer, the current method returns.

Restituisce

Attività che rappresenta l'operazione di lettura asincrona.A task that represents the asynchronous read operation. Il valore del parametro di TResult contiene il numero totale di byte letti nel buffer.The value of the TResult parameter contains the total number of bytes read into the buffer. Il valore del risultato può essere minore del numero di byte richiesti se il numero di byte attualmente disponibili è minore di quelli richiesti o può essere pari a zero se è stata raggiunta la fine del testo.The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the text has been reached.

Eccezioni

La somma di index e count è maggiore della lunghezza del buffer.The sum of index and count is larger than the buffer length.

Il lettore di testo è stato eliminato.The text reader has been disposed.

Il lettore è attualmente usato da un'operazione di lettura precedente.The reader is currently in use by a previous read operation.

Commenti

L'attività viene completata dopo che il numero di caratteri specificato da di count parametro vengono lette o viene raggiunta la fine del file.The task completes after either the number of characters specified by the count parameter are read or the end of the file is reached.

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 ReadAsync metodo, vedere il StreamReader.ReadAsync (metodo).For an example of using the ReadAsync method, see the StreamReader.ReadAsync method.

Vedi anche

ReadAsync(Memory<Char>, CancellationToken) ReadAsync(Memory<Char>, CancellationToken)

public virtual System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<char> buffer, System.Threading.CancellationToken cancellationToken = null);
abstract member ReadAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
override this.ReadAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Parametri

buffer
Memory<Char>

Restituisce

Si applica a