Partager via


XmlReader.ReadOuterXmlAsync Méthode

Définition

Lit de façon asynchrone le contenu, y compris le balisage, représentant ce nœud et tous ses enfants.

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

Retours

Si le lecteur est positionné sur un élément ou un nœud d’attribut, cette méthode retourne tout le contenu XML, y compris le balisage, du nœud actuel et de tous ses enfants ; sinon, elle retourne une chaîne vide.

Exceptions

Une XmlReader 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 XmlReaderSettings.Async sur true si vous souhaitez utiliser des méthodes asynchrones ».

Remarques

Il s’agit de la version asynchrone de ReadOuterXml, 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 ReadOuterXml().

S’applique à

Voir aussi