Freigeben über


XmlWriter.WriteBase64Async(Byte[], Int32, Int32) Methode

Definition

Codiert die angegebenen Binärbytes asynchron als Base64 und schreibt den resultierenden Text aus.

public:
 virtual System::Threading::Tasks::Task ^ WriteBase64Async(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task WriteBase64Async(byte[] buffer, int index, int count);
abstract member WriteBase64Async : byte[] * int * int -> System.Threading.Tasks.Task
override this.WriteBase64Async : byte[] * int * int -> System.Threading.Tasks.Task
Public Overridable Function WriteBase64Async (buffer As Byte(), index As Integer, count As Integer) As Task

Parameter

buffer
Byte[]

Bytearray, das codiert werden soll.

index
Int32

Die Position im Puffer, die den Anfang der zu schreibenden Bytes angibt.

count
Int32

Die Anzahl der zu schreibenden Bytes.

Gibt zurück

Die Aufgabe, die den asynchronen WriteBase64 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 WriteBase64, 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 WriteBase64(Byte[], Int32, Int32).

Gilt für:

Weitere Informationen