XmlReader.ReadValueChunkAsync(Char[], Int32, Int32) Método

Definição

Lê de forma assíncrona grandes fluxos de texto inserido em um documento 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)

Parâmetros

buffer
Char[]

A matriz de caracteres que serve como o buffer no qual os conteúdos de texto são gravados.The array of characters that serves as the buffer to which the text contents are written. Este valor pode não ser null.This value cannot be null.

index
Int32

O deslocamento dentro do buffer em que o XmlReader pode começar a copiar os resultados.The offset within the buffer where the XmlReader can start to copy the results.

count
Int32

O número máximo de caracteres a ser copiado para o buffer.The maximum number of characters to copy into the buffer. O número real de caracteres copiado é retornado deste método.The actual number of characters copied is returned from this method.

Retornos

Task<Int32>

O número de caracteres lidos no buffer.The number of characters read into the buffer. O valor zero é retornado quando não há mais nenhum conteúdo de texto.The value zero is returned when there is no more text content.

Exceções

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress." - ou --or-

Um método assíncrono XmlReader foi chamado sem definir o sinalizador Async como true.An XmlReader asynchronous method was called without setting the Async flag to true. Neste caso, InvalidOperationException é gerado com a mensagem: “Defina XmlReaderSettings.Async como verdadeiro se desejar usar Métodos Assíncronos”.In this case, InvalidOperationException is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods."

Comentários

Essa é a versão assíncrona do ReadValueChunk , com a mesma funcionalidade.This is the asynchronous version of ReadValueChunk, with the same functionality. Para usar esse método, você deve definir o Async sinalizador como true .To use this method, you must set the Async flag to true.

Aplica-se a