TextWriter.WriteAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Escreve dados no fluxo de texto de forma assíncrona.
Sobrecargas
| Name | Description |
|---|---|
| WriteAsync(String, CancellationToken) | |
| WriteAsync(Char[], Int32, Int32) |
Escreve um subarray de caracteres no fluxo de texto de forma assíncrona. |
| WriteAsync(StringBuilder, CancellationToken) |
Escreve assíncronamente um construtor de strings no fluxo de texto. |
| WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
De forma assíncrona, escreve uma região de memória de caracteres no fluxo de texto. |
| WriteAsync(Char) |
Escreve um carácter no fluxo de texto de forma assíncrona. |
| WriteAsync(String) |
Escreve uma string no fluxo de texto de forma assíncrona. |
| WriteAsync(Char[]) |
Escreve um array de caracteres no fluxo de texto de forma assíncrona. |
| WriteAsync(Rune) |
WriteAsync(String, CancellationToken)
- Origem:
- TextWriter.cs
public:
System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task WriteAsync(string? value, System.Threading.CancellationToken cancellationToken);member this.WriteAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function WriteAsync (value As String, cancellationToken As CancellationToken) As TaskParâmetros
- value
- String
- cancellationToken
- CancellationToken
Devoluções
Aplica-se a
WriteAsync(Char[], Int32, Int32)
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
Escreve um subarray de caracteres no fluxo de texto de forma assíncrona.
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.TaskPublic Overridable Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As TaskParâmetros
- buffer
- Char[]
O array de caracteres para escrever dados.
- index
- Int32
A posição do carácter no buffer onde começar a recolher dados.
- count
- Int32
O número de caracteres a escrever.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
buffer é null.
O index ponto positivo count é maior do que o comprimento do buffer.
index ou count é negativo.
O autor do texto está disponível.
O escritor de texto está atualmente em uso por uma operação de escrita anterior.
Observações
A TextWriter disciplina é uma disciplina abstrata. Portanto, não o instancias no teu código. Para um exemplo de utilização do WriteAsync método, veja o StreamWriter.WriteAsync método.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(Char[], Int32, Int32).
Ver também
Aplica-se a
WriteAsync(StringBuilder, CancellationToken)
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
Escreve assíncronamente um construtor de strings no fluxo de texto.
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.TaskPublic Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- value
- StringBuilder
A cadeia, como construtora de cadeias, para escrever no fluxo de texto.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método é equivalente a chamar WriteAsync(stringBuilder.ToString()), no entanto, usa o StringBuilder.GetChunks() método para evitar criar a cadeia intermédia.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(StringBuilder).
Aplica-se a
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
De forma assíncrona, escreve uma região de memória de caracteres no fluxo de texto.
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.TaskPublic Overridable Function WriteAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- buffer
- ReadOnlyMemory<Char>
A região de memória de caracteres para escrever no fluxo de texto.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Aplica-se a
WriteAsync(Char)
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
Escreve um carácter no fluxo de texto de forma assíncrona.
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.TaskPublic Overridable Function WriteAsync (value As Char) As TaskParâmetros
- value
- Char
O carácter a escrever no fluxo de texto.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
O autor do texto está disponível.
O escritor de texto está atualmente em uso por uma operação de escrita anterior.
Observações
A TextWriter disciplina é uma disciplina abstrata. Portanto, não o instancias no teu código. Para um exemplo de utilização do WriteAsync método, veja o StreamWriter.WriteAsync método.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(Char).
Ver também
Aplica-se a
WriteAsync(String)
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
Escreve uma string no fluxo de texto de forma assíncrona.
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.TaskPublic Overridable Function WriteAsync (value As String) As TaskParâmetros
- value
- String
A sequência para escrever. Se value for null, nada é escrito no fluxo de texto.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
O autor do texto está disponível.
O escritor de texto está atualmente em uso por uma operação de escrita anterior.
Observações
A TextWriter disciplina é uma disciplina abstrata. Portanto, não o instancias no teu código. Para um exemplo de utilização do WriteAsync método, veja o StreamWriter.WriteAsync método.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(String).
Ver também
Aplica-se a
WriteAsync(Char[])
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
- Origem:
- TextWriter.cs
Escreve um array de caracteres no fluxo de texto de forma assíncrona.
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.TaskPublic Function WriteAsync (buffer As Char()) As TaskParâmetros
- buffer
- Char[]
O array de caracteres para escrever no fluxo de texto. Se buffer for null, nada está escrito.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
- Atributos
Exceções
O autor do texto está disponível.
O escritor de texto está atualmente em uso por uma operação de escrita anterior.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(Char[]).
Ver também
Aplica-se a
WriteAsync(Rune)
- Origem:
- TextWriter.cs
public:
virtual System::Threading::Tasks::Task ^ WriteAsync(System::Text::Rune value);public virtual System.Threading.Tasks.Task WriteAsync(System.Text.Rune value);abstract member WriteAsync : System.Text.Rune -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.Rune -> System.Threading.Tasks.TaskPublic Overridable Function WriteAsync (value As Rune) As TaskParâmetros
- value
- Rune
