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

Definicja

Asynchronicznie odczytuje duże strumienie tekstu osadzone w dokumencie XML.Asynchronously reads large streams of text embedded in an XML document.

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.The array of characters that serves as the buffer to which the text contents are written. Ta wartość nie może być null.This value cannot be null.

index
Int32

Przesunięcie w buforze, w którym XmlReader może rozpocząć kopiowanie wyników.The offset within the buffer where the XmlReader can start to copy the results.

count
Int32

Maksymalna liczba znaków do skopiowania do buforu.The maximum number of characters to copy into the buffer. Rzeczywista liczba skopiowanych znaków jest zwracana z tej metody.The actual number of characters copied is returned from this method.

Zwraca

Liczba znaków odczytywanych w buforze.The number of characters read into the buffer. Wartość zero jest zwracana, gdy nie ma więcej zawartości tekstowej.The value zero is returned when there is no more text content.

Wyjątki

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress." lub-or-

Metoda asynchroniczna XmlReader została wywołana bez ustawienia flagi Async do true.An XmlReader asynchronous method was called without setting the Async flag to true. W takim przypadku InvalidOperationException jest generowany z komunikatem "Ustaw tabela XmlReaderSettings. Async to true, jeśli chcesz użyć metod asynchronicznych".In this case, InvalidOperationException is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods."

Uwagi

Jest to asynchroniczna wersja ReadValueChunkz tą samą funkcjonalnością.This is the asynchronous version of ReadValueChunk, with the same functionality. Aby użyć tej metody, należy ustawić flagę Async, aby true.To use this method, you must set the Async flag to true.

Dotyczy

Zobacz też