XmlWriter.WriteStringAsync(String) Método

Definição

Escreve assíncronamente o conteúdo do texto indicado.

public:
 virtual System::Threading::Tasks::Task ^ WriteStringAsync(System::String ^ text);
public virtual System.Threading.Tasks.Task WriteStringAsync(string text);
public virtual System.Threading.Tasks.Task WriteStringAsync(string? text);
abstract member WriteStringAsync : string -> System.Threading.Tasks.Task
override this.WriteStringAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteStringAsync (text As String) As Task

Parâmetros

text
String

O texto para escrever.

Devoluções

A tarefa que representa a operação assíncrona WriteString .

Exceções

Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

-ou-

Um XmlWriter método assíncrono era chamado sem definir a Async flag para true. Neste caso, InvalidOperationException aparece com a mensagem "Definir XmlWriterSettings.Async como true se quiseres usar Métodos Assíncronos."

Observações

Esta é a versão assíncrona de WriteString, com a mesma funcionalidade. Para usar este método, deve definir o Async flag para true.

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

Aplica-se a

Ver também