TextWriter.WriteAsync Método

Definição

Grava dados no fluxo de texto de forma assíncrona.Writes data to the text stream asynchronously.

Sobrecargas

WriteAsync(Char[], Int32, Int32)

Grava uma submatriz de caracteres no fluxo de texto de forma assíncrona.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken)

Grava de forma assíncrona um construtor de cadeia de caracteres no fluxo de texto.Asynchronously writes a string builder to the text stream.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Grava a região da memória do caractere no fluxo de texto de forma assíncrona.Asynchronously writes a character memory region to the text stream.

WriteAsync(String)

Grava uma cadeia de caracteres no fluxo de texto de forma assíncrona.Writes a string to the text stream asynchronously.

WriteAsync(Char[])

Grava uma matriz de caracteres no fluxo de texto de forma assíncrona.Writes a character array to the text stream asynchronously.

WriteAsync(Char)

Grava um caractere no fluxo de texto de forma assíncrona.Writes a character to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32)

Grava uma submatriz de caracteres no fluxo de texto de forma assíncrona.Writes a subarray of characters to the text stream asynchronously.

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);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Parâmetros

buffer
Char[]

A matriz de caracteres da qual os dados serão gravados.The character array to write data from.

index
Int32

A posição do caractere no buffer em que iniciar a recuperação de dados.The character position in the buffer at which to start retrieving data.

count
Int32

O número de caracteres a serem gravados.The number of characters to write.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

buffer é null.buffer is null.

O index mais count é maior que o comprimento do buffer.The index plus count is greater than the buffer length.

index ou count é negativo.index or count is negative.

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

A classe TextWriter é uma classe abstrata.The TextWriter class is an abstract class. Portanto, você não a instancia em seu código.Therefore, you do not instantiate it in your code. Para obter um exemplo de como usar o WriteAsync método, consulte o StreamWriter.WriteAsync método.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Confira também

Aplica-se a

WriteAsync(StringBuilder, CancellationToken)

Grava de forma assíncrona um construtor de cadeia de caracteres no fluxo de texto.Asynchronously writes a string builder to the text stream.

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

Parâmetros

value
StringBuilder

A cadeia de caracteres, como um construtor de cadeia de caracteres, a ser gravada no fluxo de texto.The string, as a string builder, to write to the text stream.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.The token to monitor for cancellation requests. O valor padrão é None.The default value is None.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Comentários

No entanto, esse método é equivalente a chamar WriteAsync(stringBuilder.ToString()) . ele usa o StringBuilder.GetChunks() método para evitar a criação da cadeia de caracteres intermediária.This method is equivalent to calling WriteAsync(stringBuilder.ToString()), however, it uses the StringBuilder.GetChunks() method to avoid creating the intermediate string.

Aplica-se a

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Grava a região da memória do caractere no fluxo de texto de forma assíncrona.Asynchronously writes a character memory region to the text stream.

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

Parâmetros

buffer
ReadOnlyMemory<Char>

A região da memória do caractere a ser gravado no fluxo de texto.The character memory region to write to the text stream.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.The token to monitor for cancellation requests. O valor padrão é None.The default value is None.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Aplica-se a

WriteAsync(String)

Grava uma cadeia de caracteres no fluxo de texto de forma assíncrona.Writes a string to the text stream asynchronously.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);
public virtual System.Threading.Tasks.Task WriteAsync (string value);
public virtual System.Threading.Tasks.Task WriteAsync (string? value);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Parâmetros

value
String

A cadeia de caracteres a ser gravada.The string to write. Se value for null, nada será gravado no fluxo de texto.If value is null, nothing is written to the text stream.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

A classe TextWriter é uma classe abstrata.The TextWriter class is an abstract class. Portanto, você não a instancia em seu código.Therefore, you do not instantiate it in your code. Para obter um exemplo de como usar o WriteAsync método, consulte o StreamWriter.WriteAsync método.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Confira também

Aplica-se a

WriteAsync(Char[])

Grava uma matriz de caracteres no fluxo de texto de forma assíncrona.Writes a character array to the text stream asynchronously.

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);
public System.Threading.Tasks.Task WriteAsync (char[] buffer);
public System.Threading.Tasks.Task WriteAsync (char[]? buffer);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteAsync (char[] buffer);
member this.WriteAsync : char[] -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.WriteAsync : char[] -> System.Threading.Tasks.Task
Public Function WriteAsync (buffer As Char()) As Task

Parâmetros

buffer
Char[]

A matriz de caracteres a ser gravada no fluxo de texto.The character array to write to the text stream. Se buffer for null, nada será gravado.If buffer is null, nothing is written.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Confira também

Aplica-se a

WriteAsync(Char)

Grava um caractere no fluxo de texto de forma assíncrona.Writes a character to the text stream asynchronously.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);
public virtual System.Threading.Tasks.Task WriteAsync (char value);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Parâmetros

value
Char

O caractere a ser gravado no fluxo de texto.The character to write to the text stream.

Retornos

Task

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Atributos

Exceções

O gravador de texto é descartado.The text writer is disposed.

O gravador de texto está sendo usado no momento por uma operação de gravação anterior.The text writer is currently in use by a previous write operation.

Comentários

A classe TextWriter é uma classe abstrata.The TextWriter class is an abstract class. Portanto, você não a instancia em seu código.Therefore, you do not instantiate it in your code. Para obter um exemplo de como usar o WriteAsync método, consulte o StreamWriter.WriteAsync método.For an example of using the WriteAsync method, see the StreamWriter.WriteAsync method.

Confira também

Aplica-se a