XmlWriter.WriteElementStringAsync(String, String, String, String) Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs
Origem:
XmlWriterAsync.cs

Escreve assíncronamente um elemento com o prefixo especificado, nome local, URI do espaço de nomes e valor.

public:
 System::Threading::Tasks::Task ^ WriteElementStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);
public System.Threading.Tasks.Task WriteElementStringAsync(string prefix, string localName, string ns, string value);
public System.Threading.Tasks.Task WriteElementStringAsync(string? prefix, string localName, string? ns, string value);
member this.WriteElementStringAsync : string * string * string * string -> System.Threading.Tasks.Task
Public Function WriteElementStringAsync (prefix As String, localName As String, ns As String, value As String) As Task

Parâmetros

prefix
String

O prefixo do elemento.

localName
String

O nome local do elemento.

ns
String

O URI do namespace do elemento.

value
String

O valor do elemento.

Devoluções

Task

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

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

Aplica-se a

Ver também