XmlWriter.WriteStartElementAsync(String, String, String) Methode
Definition
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.
Schreibt asynchron das angegebene Starttag und ordnet es dem angegebenen Namespace und Präfix zu.
public:
virtual System::Threading::Tasks::Task ^ WriteStartElementAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns);public virtual System.Threading.Tasks.Task WriteStartElementAsync(string prefix, string localName, string ns);public virtual System.Threading.Tasks.Task WriteStartElementAsync(string? prefix, string localName, string? ns);abstract member WriteStartElementAsync : string * string * string -> System.Threading.Tasks.Task
override this.WriteStartElementAsync : string * string * string -> System.Threading.Tasks.TaskPublic Overridable Function WriteStartElementAsync (prefix As String, localName As String, ns As String) As TaskParameter
- prefix
- String
Das Namespacepräfix des Elements.
- localName
- String
Der lokale Name des Elements.
- ns
- String
Der Namespace-URI, der dem Element zugeordnet werden soll.
Gibt zurück
Die Aufgabe, die den asynchronen WriteStartElement 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 WriteStartElement, 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 WriteStartElement(String, String, String).
