Freigeben über


XmlWriter.WriteStartDocumentAsync Methode

Definition

Schreibt asynchron die XML-Deklaration.

Überlädt

Name Beschreibung
WriteStartDocumentAsync()

Schreibt asynchron die XML-Deklaration mit der Version "1.0".

WriteStartDocumentAsync(Boolean)

Schreibt asynchron die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.

Hinweise

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

WriteStartDocumentAsync()

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

Schreibt asynchron die XML-Deklaration mit der Version "1.0".

public:
 virtual System::Threading::Tasks::Task ^ WriteStartDocumentAsync();
public virtual System.Threading.Tasks.Task WriteStartDocumentAsync();
abstract member WriteStartDocumentAsync : unit -> System.Threading.Tasks.Task
override this.WriteStartDocumentAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function WriteStartDocumentAsync () As Task

Gibt zurück

Die Aufgabe, die den asynchronen WriteStartDocument 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 WriteStartDocument, 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 WriteStartDocument().

Weitere Informationen

Gilt für:

WriteStartDocumentAsync(Boolean)

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

Schreibt asynchron die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.

public:
 virtual System::Threading::Tasks::Task ^ WriteStartDocumentAsync(bool standalone);
public virtual System.Threading.Tasks.Task WriteStartDocumentAsync(bool standalone);
abstract member WriteStartDocumentAsync : bool -> System.Threading.Tasks.Task
override this.WriteStartDocumentAsync : bool -> System.Threading.Tasks.Task
Public Overridable Function WriteStartDocumentAsync (standalone As Boolean) As Task

Parameter

standalone
Boolean

Wenn true, schreibt er "standalone=yes"; if false, it writes "standalone=no".

Gibt zurück

Die Aufgabe, die den asynchronen WriteStartDocument 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 WriteStartDocument, 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 WriteStartDocument(Boolean).

Weitere Informationen

Gilt für: