XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Metoda
Definicja
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
.
- count
- Int32
Maksymalna liczba znaków do skopiowania do buforu. Rzeczywista liczba skopiowanych znaków jest zwracana z tej metody.
Zwraca
Liczba znaków odczytanych do buforu. Wartość zero jest zwracana, gdy nie ma więcej zawartości tekstowej.
Wyjątki
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
.