Freigeben über


XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Methode

Definition

Liest asynchron umfangreiche Streams von Text, der in ein XML-Dokument eingebettet ist.

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

Parameter

buffer
Char[]

Das Array von Zeichen, das als Puffer dient, in den der Textinhalt geschrieben wird. Dieser Wert darf nicht null sein.

index
Int32

Der Offset im Puffer, ab dem der XmlReader die Ergebnisse kopieren kann.

count
Int32

Die maximale Anzahl von Zeichen, die in den Puffer kopiert werden sollen. Diese Methode gibt die tatsächliche Anzahl der kopierten Zeichen zurück.

Gibt zurück

Die Anzahl der in den Puffer gelesenen Zeichen. Der Wert 0 (null) wird zurückgegeben, wenn kein weiterer Textinhalt vorhanden ist.

Ausnahmen

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird mit der Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Eine asynchrone XmlReader-Methode wurde aufgerufen, ohne das Async-Flag auf true festzulegen. In diesem Fall wird InvalidOperationException mit der Meldung „Legen Sie 'XmlReaderSettings.Async' auf 'true' fest, wenn Sie asynchrone Methoden verwenden möchten.“ ausgelöst.

Hinweise

Dies ist die asynchrone Version von mit ReadValueChunkderselben Funktionalität. Um diese Methode verwenden zu können, müssen Sie das Async Flag auf truefestlegen.

Gilt für:

Weitere Informationen