Freigeben über


XmlWriter.WriteNodeAsync Methode

Definition

Kopiert asynchron alles vom Quellobjekt in die aktuelle Writer-Instanz.

Überlädt

Name Beschreibung
WriteNodeAsync(XPathNavigator, Boolean)

Kopiert asynchron alles vom XPathNavigator Objekt in den Writer. Die Position der XPathNavigator bleibt unverändert.

WriteNodeAsync(XmlReader, Boolean)

Kopiert asynchron alles vom Leser in den Autor und verschiebt den Leser an den Anfang des nächsten gleichgeordneten Gleichgeordneten.

Hinweise

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

WriteNodeAsync(XPathNavigator, Boolean)

Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs

Kopiert asynchron alles vom XPathNavigator Objekt in den Writer. Die Position der XPathNavigator bleibt unverändert.

public:
 virtual System::Threading::Tasks::Task ^ WriteNodeAsync(System::Xml::XPath::XPathNavigator ^ navigator, bool defattr);
public virtual System.Threading.Tasks.Task WriteNodeAsync(System.Xml.XPath.XPathNavigator navigator, bool defattr);
abstract member WriteNodeAsync : System.Xml.XPath.XPathNavigator * bool -> System.Threading.Tasks.Task
override this.WriteNodeAsync : System.Xml.XPath.XPathNavigator * bool -> System.Threading.Tasks.Task
Public Overridable Function WriteNodeAsync (navigator As XPathNavigator, defattr As Boolean) As Task

Parameter

navigator
XPathNavigator

Das XPathNavigator zu kopierende Element.

defattr
Boolean

trueum die Standardattribute zu kopieren; andernfalls . false

Gibt zurück

Die Aufgabe, die den asynchronen WriteNode Vorgang darstellt.

Ausnahmen

Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

- oder -

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

Hinweise

Dies ist die asynchrone Version von WriteNode, 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 WriteNode(XPathNavigator, Boolean).

Weitere Informationen

Gilt für:

WriteNodeAsync(XmlReader, Boolean)

Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs
Quelle:
XmlWriterAsync.cs

Kopiert asynchron alles vom Leser in den Autor und verschiebt den Leser an den Anfang des nächsten gleichgeordneten Gleichgeordneten.

public:
 virtual System::Threading::Tasks::Task ^ WriteNodeAsync(System::Xml::XmlReader ^ reader, bool defattr);
public virtual System.Threading.Tasks.Task WriteNodeAsync(System.Xml.XmlReader reader, bool defattr);
abstract member WriteNodeAsync : System.Xml.XmlReader * bool -> System.Threading.Tasks.Task
override this.WriteNodeAsync : System.Xml.XmlReader * bool -> System.Threading.Tasks.Task
Public Overridable Function WriteNodeAsync (reader As XmlReader, defattr As Boolean) As Task

Parameter

reader
XmlReader

Der XmlReader zu lesende Text.

defattr
Boolean

true um die Standardattribute aus dem XmlReader; andernfalls falsezu kopieren.

Gibt zurück

Die Aufgabe, die den asynchronen WriteNode Vorgang darstellt.

Ausnahmen

Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

- oder -

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

Hinweise

Dies ist die asynchrone Version von WriteNode, 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 WriteNode(XmlReader, Boolean).

Weitere Informationen

Gilt für: