TextWriter.WriteAsync Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Scrive i dati nel flusso di testo in modo asincrono.

Overload

WriteAsync(Char[], Int32, Int32)	Scrive una sottomatrice di caratteri nel flusso di testo in modo asincrono.
WriteAsync(StringBuilder, CancellationToken)	Scrive in modo asincrono un generatore di stringhe nel flusso di testo.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Scrive in modo asincrono un'area di memoria dei caratteri nel flusso di testo.
WriteAsync(String)	Scrive una stringa nel flusso di testo in modo asincrono.
WriteAsync(Char[])	Scrive una matrice di caratteri in modo asincrono nel flusso di testo.
WriteAsync(Char)	Scrive un carattere nel flusso di testo in modo asincrono.

WriteAsync(Char[], Int32, Int32)

Origine:

TextWriter.cs

Scrive una sottomatrice di caratteri nel flusso di testo in modo asincrono.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer, int index, int count);

public virtual System.Threading.Tasks.Task WriteAsync (char[] buffer, int index, int count);

abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As Task

Parametri

buffer

Char[]

Matrice di caratteri da cui scrivere i dati.

index

Int32

Posizione del carattere nel buffer da cui iniziare il recupero dei dati.

count

Int32

Numero di caratteri da scrivere.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ArgumentNullException

buffer è null.

ArgumentException

La somma di index e count è maggiore della lunghezza del buffer.

ArgumentOutOfRangeException

index o count è negativo.

ObjectDisposedException

Il writer di testo viene eliminato.

InvalidOperationException

Il writer di testo è attualmente utilizzato da un'operazione di scrittura precedente.

Commenti

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

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 Write(Char[], Int32, Int32).

Vedi anche

• WriteAsync(Char[], Int32, Int32)
• WriteAsync(Char[], Int32, Int32)

WriteAsync(StringBuilder, CancellationToken)

Origine:

TextWriter.cs

Scrive in modo asincrono un generatore di stringhe nel flusso di testo.

public virtual System.Threading.Tasks.Task WriteAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

value

StringBuilder

Stringa, come un generatore di stringhe, da scrivere nel flusso di testo.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

OperationCanceledException

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

Commenti

Questo metodo equivale a chiamare WriteAsync(stringBuilder.ToString()), tuttavia, usa il StringBuilder.GetChunks() metodo per evitare di creare la stringa intermedia.

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 Write(StringBuilder).

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Origine:

TextWriter.cs

Scrive in modo asincrono un'area di memoria dei caratteri nel flusso di testo.

public virtual System.Threading.Tasks.Task WriteAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

buffer

ReadOnlyMemory<Char>

Area di memoria dei caratteri da scrivere nel flusso di testo.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

OperationCanceledException

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

WriteAsync(String)

Origine:

TextWriter.cs

Scrive una stringa nel flusso di testo in modo asincrono.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);

public virtual System.Threading.Tasks.Task WriteAsync (string? value);

abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As String) As Task

Parametri

value

String

Stringa da scrivere. Se value è null, nel flusso di testo non viene scritto alcun dato.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ObjectDisposedException

Il writer di testo viene eliminato.

InvalidOperationException

Il writer di testo è attualmente utilizzato da un'operazione di scrittura precedente.

Commenti

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

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 Write(String).

Vedi anche

• WriteAsync(String)
• WriteAsync(String)

WriteAsync(Char[])

Origine:

TextWriter.cs

Scrive una matrice di caratteri in modo asincrono nel flusso di testo.

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);

public System.Threading.Tasks.Task WriteAsync (char[]? buffer);

member this.WriteAsync : char[] -> System.Threading.Tasks.Task

Public Function WriteAsync (buffer As Char()) As Task

Parametri

buffer

Char[]

Matrice di caratteri da scrivere nel flusso di testo. Se buffer è null, non viene scritta alcuna voce.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ObjectDisposedException

Il writer di testo viene eliminato.

InvalidOperationException

Il writer di testo è attualmente utilizzato da un'operazione di scrittura precedente.

Commenti

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 Write(Char[]).

Vedi anche

• StreamWriter
• StringWriter

WriteAsync(Char)

Origine:

TextWriter.cs

Scrive un carattere nel flusso di testo in modo asincrono.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);

public virtual System.Threading.Tasks.Task WriteAsync (char value);

abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As Char) As Task

Parametri

value

Char

Carattere da scrivere nel flusso di testo.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ObjectDisposedException

Il writer di testo viene eliminato.

InvalidOperationException

Il writer di testo è attualmente utilizzato da un'operazione di scrittura precedente.

Commenti

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

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 Write(Char).

Vedi anche

• WriteAsync(Char)
• WriteAsync(Char)