XmlWriter.WriteAttributeStringAsync(String, String, String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrit de façon asynchrone l’attribut avec le préfixe, le nom local, l’URI de l’espace de noms et la valeur spécifiés.
public:
System::Threading::Tasks::Task ^ WriteAttributeStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);
public System.Threading.Tasks.Task WriteAttributeStringAsync(string prefix, string localName, string ns, string value);
public System.Threading.Tasks.Task WriteAttributeStringAsync(string? prefix, string localName, string? ns, string? value);
member this.WriteAttributeStringAsync : string * string * string * string -> System.Threading.Tasks.Task
Public Function WriteAttributeStringAsync (prefix As String, localName As String, ns As String, value As String) As Task
Paramètres
- prefix
- String
Préfixe d’espace de noms de l’attribut.
- localName
- String
Nom local de l’attribut.
- ns
- String
URI d’espace de noms de l’attribut.
- value
- String
Valeur de l’attribut.
Retours
Tâche qui représente l’opération asynchrone WriteAttributeString .
Exceptions
Une XmlWriter méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».
- ou -
Une XmlWriter méthode asynchrone a été appelée sans définir l’indicateur Asynctruesur . Dans ce cas, InvalidOperationException est levée avec le message « Définir XmlWriterSettings.Async sur true si vous souhaitez utiliser des méthodes asynchrones ».
Remarques
Il s’agit de la version asynchrone de WriteAttributeString, avec la même fonctionnalité. Pour utiliser cette méthode, vous devez définir l’indicateur Async sur true.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par WriteAttributeString(String, String, String, String).