Freigeben über


XmlReader.ReadOuterXmlAsync Methode

Definition

Liest den Inhalt asynchron vor, einschließlich Markup, der diesen Knoten und alle untergeordneten Elemente darstellt.

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)

Gibt zurück

Wenn der Leser auf einem Element oder einem Attributknoten positioniert ist, gibt diese Methode den gesamten XML-Inhalt einschließlich Markup des aktuellen Knotens und aller untergeordneten Elemente zurück. andernfalls wird eine leere Zeichenfolge zurückgegeben.

Ausnahmen

Eine XmlReader asynchrone Methode wurde aufgerufen, ohne die Async Kennzeichnung auf .true In diesem Fall wird die Meldung "Set XmlReaderSettings.Async to true" ausgelöst, InvalidOperationException wenn Sie Async-Methoden verwenden möchten.

Hinweise

Dies ist die asynchrone Version von ReadOuterXml, mit der gleichen Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Kennzeichen auf true.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von ReadOuterXml().

Gilt für:

Weitere Informationen