TextReader.ReadLineAsync Metodo

Definizione

Overload

ReadLineAsync()

Legge una riga di caratteri in modo asincrono e restituisce i dati come stringa.

ReadLineAsync(CancellationToken)

Legge una riga di caratteri in modo asincrono e restituisce i dati come stringa.

ReadLineAsync()

Legge una riga di caratteri in modo asincrono e restituisce i dati come stringa.

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();
public virtual System.Threading.Tasks.Task<string> ReadLineAsync ();
public virtual System.Threading.Tasks.Task<string?> ReadLineAsync ();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task<string> ReadLineAsync ();
abstract member ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
Public Overridable Function ReadLineAsync () As Task(Of String)

Restituisce

Attività che rappresenta l'operazione di lettura asincrona. Il valore del parametro TResult contiene la riga successiva del lettore di testo oppure è null se tutti i caratteri sono stati letti.

Attributi

Eccezioni

Il numero di caratteri nella riga successiva è maggiore di Int32.MaxValue.

Il lettore di testo è stato eliminato.

Il lettore è attualmente usato da un'operazione di lettura precedente.

Commenti

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

Se l'oggetto corrente TextReader rappresenta il flusso di input standard restituito dalla Console.In proprietà , il ReadLineAsync metodo viene eseguito in modo sincrono anziché asincrono.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ReadLine().

Vedi anche

Si applica a

ReadLineAsync(CancellationToken)

Legge una riga di caratteri in modo asincrono e restituisce i dati come stringa.

public:
 virtual System::Threading::Tasks::ValueTask<System::String ^> ReadLineAsync(System::Threading::CancellationToken cancellationToken);
public virtual System.Threading.Tasks.ValueTask<string?> ReadLineAsync (System.Threading.CancellationToken cancellationToken);
abstract member ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>
override this.ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>
Public Overridable Function ReadLineAsync (cancellationToken As CancellationToken) As ValueTask(Of String)

Parametri

cancellationToken
CancellationToken

Token da monitorare per le richieste di annullamento.

Restituisce

Attività valore che rappresenta l'operazione di lettura asincrona. Il valore del parametro TResult contiene la riga successiva del lettore di testo oppure è null se tutti i caratteri sono stati letti.

Eccezioni

Il numero di caratteri nella riga successiva è maggiore di Int32.MaxValue.

Il lettore di testo è stato eliminato.

Il lettore è attualmente usato da un'operazione di lettura precedente.

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

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

Se l'oggetto corrente TextReader rappresenta il flusso di input standard restituito dalla Console.In proprietà , il ReadLineAsync(CancellationToken) metodo viene eseguito in modo sincrono anziché asincrono.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da ReadLine().

Si applica a