TextReader.ReadLineAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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()
- Origine:
- TextReader.cs
- Origine:
- TextReader.cs
- Origine:
- TextReader.cs
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 uso 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 esegue in modo sincrono anziché asincrono.
Questo metodo archivia nell'attività che 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
- ReadLineAsync()
- ReadLineAsync()
- File e Stream I/O
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
ReadLineAsync(CancellationToken)
- Origine:
- TextReader.cs
- Origine:
- TextReader.cs
- Origine:
- TextReader.cs
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 uso 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 esegue in modo sincrono anziché asincrono.
Questo metodo archivia nell'attività che 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().