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(Char[], Int32, Int32) |
Escreve um subarray de caracteres no fluxo de texto de forma assíncrona. |
| WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
De forma assíncrona, escreve uma região de memória de caracteres no fluxo de texto. |
| WriteAsync(String) |
Escreve uma string no fluxo de texto de forma assíncrona. |
| WriteAsync(Char) |
Escreve um carácter no fluxo de texto de forma assíncrona. |
| WriteAsync(Char[]) |
Escreve um array de caracteres no fluxo de texto de forma assíncrona. |
WriteAsync(Char[], Int32, Int32)
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(ReadOnlyMemory<Char>, CancellationToken)
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(String)
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);[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)
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(Char[])
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);[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[]).