XmlDictionaryWriter.WriteValueAsync(IStreamProvider) Método

Definição

Espaço de Nomes:
System.Xml
Assemblagem:
System.Runtime.Serialization.dll
Assemblagem:
netstandard.dll

Escreve assíncronamente um valor a partir de um IStreamProvider.

public:
 virtual System::Threading::Tasks::Task ^ WriteValueAsync(System::Xml::IStreamProvider ^ value);
public virtual System.Threading.Tasks.Task WriteValueAsync(System.Xml.IStreamProvider value);
abstract member WriteValueAsync : System.Xml.IStreamProvider -> System.Threading.Tasks.Task
override this.WriteValueAsync : System.Xml.IStreamProvider -> System.Threading.Tasks.Task
Public Overridable Function WriteValueAsync (value As IStreamProvider) As Task

Parâmetros

value
IStreamProvider

O IStreamProvider valor a escrever.

Devoluções

Task

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

Exceções

InvalidOperationException

Um XmlDictionaryWriter 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 XmlDictionaryWriter 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 WriteValue, 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 WriteValue(IStreamProvider).

Aplica-se a

Ver também