XmlWriter.WriteNodeAsync Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Kopiert den gesamten Inhalt des Quellobjekts asynchron in die aktuelle Writer-Instanz.
| WriteNodeAsync(XPathNavigator, Boolean) |
Kopiert asynchron den gesamten Inhalt des XPathNavigator-Objekt in den Writer. Die Position des XPathNavigator bleibt unverändert. |
| WriteNodeAsync(XmlReader, Boolean) |
Kopiert beim Überschreiben in einer abgeleiteten Klasse den gesamten Inhalt des Readers asynchron in den Writer und verschiebt den Reader zum Anfang des nächsten nebengeordneten Elements. |
Dies ist die asynchrone Version von WriteNode, mit derselben Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Flag auf truefestlegen.
Kopiert asynchron den gesamten Inhalt des XPathNavigator-Objekt in den Writer. Die Position des 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.TaskPublic Overridable Function WriteNodeAsync (navigator As XPathNavigator, defattr As Boolean) As TaskParameter
- navigator
- XPathNavigator
Der XPathNavigator, aus dem kopiert werden soll.
- defattr
- Boolean
true, um 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 wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.
- oder -
Eine asynchrone XmlWriter-Methode wurde aufgerufen, ohne das Async-Flag auf true festzulegen. In diesem Fall wird InvalidOperationException mit der Nachricht „Legen Sie XmlWriterSettings.Async auf True fest, wenn Sie die Async-Methoden verwenden möchten“ ausgelöst.
Hinweise
Dies ist die asynchrone Version von WriteNode, mit derselben Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Kennzeichen auf truefestlegen.
Siehe auch
Gilt für
.NET 7 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 2.0, 2.1 |
Kopiert beim Überschreiben in einer abgeleiteten Klasse den gesamten Inhalt des Readers asynchron in den Writer und verschiebt den Reader zum Anfang des nächsten nebengeordneten Elements.
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.TaskPublic Overridable Function WriteNodeAsync (reader As XmlReader, defattr As Boolean) As TaskParameter
- defattr
- Boolean
true, um die Standardattribute aus dem XmlReader 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 wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.
- oder -
Eine asynchrone XmlWriter-Methode wurde aufgerufen, ohne das Async-Flag auf true festzulegen. In diesem Fall wird InvalidOperationException mit der Nachricht „Legen Sie XmlWriterSettings.Async auf True fest, wenn Sie die Async-Methoden verwenden möchten“ ausgelöst.
Hinweise
Dies ist die asynchrone Version von WriteNode, mit derselben Funktionalität. Um diese Methode zu verwenden, müssen Sie das Async Flag auf truefestlegen.
Siehe auch
Gilt für
.NET 7 und andere Versionen
| Produkt | Versionen |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |