XmlWriter.WriteStartElementAsync(String, String, String) Méthode

Définition

Écrit de façon asynchrone l’étiquette de début indiquée et l’associe à l’espace de noms et au préfixe spécifiés.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

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

Paramètres

prefix
String

Préfixe d'espace de noms de cet élément.The namespace prefix of the element.

localName
String

Le nom local de l'élément.The local name of the element.

ns
String

URI de l'espace de noms à associer à l'élément.The namespace URI to associate with the element.

Retours

Task

Tâche qui représente l'opération WriteStartElement asynchrone.The task that represents the asynchronous WriteStartElement operation.

Exceptions

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

- ou --or-

Une méthode asynchrone XmlWriter a été appelée sans définir l’indicateur Async sur true.An XmlWriter asynchronous method was called without setting the Async flag to true. Dans ce cas, InvalidOperationException est levée avec le message « Attribuez à XmlReaderSettings.Async la valeur True si vous voulez utiliser des méthodes asynchrones ».In this case, InvalidOperationException is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods."

Remarques

Il s’agit de la version asynchrone de WriteStartElement , avec la même fonctionnalité.This is the asynchronous version of WriteStartElement, with the same functionality. Pour utiliser cette méthode, vous devez affecter la valeur Async à l’indicateur true .To use this method, you must set the Async flag to true.

S’applique à

Voir aussi