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

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
netstandard.dll

Lê assíncronamente grandes fluxos de texto embutidos num documento 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)

Parâmetros

buffer
Char[]

O conjunto de caracteres que serve de buffer para onde o conteúdo do texto é escrito. Este valor não pode ser null.

index
Int32

O deslocamento dentro do buffer onde podem XmlReader começar a copiar os resultados.

count
Int32

O número máximo de caracteres a copiar para o buffer. O número real de caracteres copiados é devolvido deste método.

Devoluções

Task<Int32>

O número de caracteres lidos no buffer. O valor zero é devolvido quando não há mais conteúdo de texto.

Exceções

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso." -ou-

Um XmlReader método assíncrono era chamado sem definir a Async flag para true. Neste caso, InvalidOperationException aparece com a mensagem "Set XmlReaderSettings.Async to true se quiseres usar Métodos Assíncronos."

Observações

Esta é a versão assíncrona de ReadValueChunk, com a mesma funcionalidade. Para usar este método, deve definir o Async flag para true.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ReadValueChunk(Char[], Int32, Int32).

Aplica-se a

Ver também