Freigeben über


XmlWriter.WriteStartAttributeAsync(String, String, String) Methode

Definition

Schreibt asynchron den Start eines Attributs mit dem angegebenen Präfix, dem lokalen Namen und dem Namespace-URI.

protected public:
 virtual System::Threading::Tasks::Task ^ WriteStartAttributeAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns);
protected internal virtual System.Threading.Tasks.Task WriteStartAttributeAsync(string prefix, string localName, string ns);
protected internal virtual System.Threading.Tasks.Task WriteStartAttributeAsync(string? prefix, string localName, string? ns);
abstract member WriteStartAttributeAsync : string * string * string -> System.Threading.Tasks.Task
override this.WriteStartAttributeAsync : string * string * string -> System.Threading.Tasks.Task
Protected Friend Overridable Function WriteStartAttributeAsync (prefix As String, localName As String, ns As String) As Task

Parameter

prefix
String

Das Namespacepräfix des Attributs.

localName
String

Der lokale Name des Attributs.

ns
String

Der Namespace-URI für das Attribut.

Gibt zurück

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

Gilt für:

Weitere Informationen