XmlWriter.WriteEntityRefAsync(String) Método

Definição

Espaço de Nomes:

System.Xml

Assemblagens:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlWriterAsync.cs

De forma assíncrona, escreve uma referência de entidade como &name;.

public:
 virtual System::Threading::Tasks::Task ^ WriteEntityRefAsync(System::String ^ name);

public virtual System.Threading.Tasks.Task WriteEntityRefAsync(string name);

abstract member WriteEntityRefAsync : string -> System.Threading.Tasks.Task
override this.WriteEntityRefAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteEntityRefAsync (name As String) As Task

Parâmetros

name

String

O nome da entidade faz referência.

Devoluções

Task

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

Exceções

InvalidOperationException

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

Ver também

• Programação assíncrona (C#)
• Assíncrona com Async e Await (Visual Basic)