XmlWriter.WriteNmTokenAsync(String) Método

Definição

Escreve assíncronamente o nome especificado, garantindo que é um NmToken válido de acordo com a recomendação XML 1.0 do W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

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

Parâmetros

name
String

O nome a escrever.

Devoluções

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

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

Aplica-se a

Ver também