XmlWriter.WriteStartElementAsync(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 a etiqueta inicial especificada e associa-a ao namespace e prefixo dados.

public:
 virtual System::Threading::Tasks::Task ^ WriteStartElementAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns);
public virtual System.Threading.Tasks.Task WriteStartElementAsync(string prefix, string localName, string ns);
public virtual System.Threading.Tasks.Task WriteStartElementAsync(string? prefix, string localName, string? ns);
abstract member WriteStartElementAsync : string * string * string -> System.Threading.Tasks.Task
override this.WriteStartElementAsync : string * string * string -> System.Threading.Tasks.Task
Public Overridable Function WriteStartElementAsync (prefix As String, localName As String, ns As String) As Task

Parâmetros

prefix
String

O prefixo de namespace do elemento.

localName
String

O nome local do elemento.

ns
String

O URI do namespace para associar ao elemento.

Devoluções

Task

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

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

Aplica-se a

Ver também