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

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Asynchronicznie odczytuje duże strumienie tekstu osadzonego w dokumencie XML.

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)

Parametry

buffer: Char[]

Tablica znaków, która służy jako bufor, do którego jest zapisywana zawartość tekstu. Ta wartość nie może być wartością null.

index: Int32

Przesunięcie w buforze, w którym XmlReader można rozpocząć kopiowanie wyników.

count: Int32

Maksymalna liczba znaków do skopiowania do buforu. Rzeczywista liczba skopiowanych znaków jest zwracana z tej metody.

Zwraca

Task<Int32>

Liczba znaków odczytanych do buforu. Wartość zero jest zwracana, gdy nie ma więcej zawartości tekstowej.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku". -lub-

Wywołano XmlReader metodę asynchroniczną bez ustawiania flagi na Async true. W tym przypadku jest zgłaszany komunikat "Set XmlReaderSettings.Async na wartość true, InvalidOperationException jeśli chcesz użyć metod asynchronicznych".

Uwagi

Jest to asynchroniczna wersja programu ReadValueChunk, z tą samą funkcjonalnością. Aby użyć tej metody, należy ustawić flagę Async na true.

Dotyczy