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

Riferimento

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Legge in modo asincrono flussi di testo di grandi dimensioni incorporati in un 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)

Parametri

buffer: Char[]

Matrice di caratteri che funge da buffer in cui viene scritto il contenuto di testo. Questo valore non può essere null.

index: Int32

L'offset all'interno del buffer in cui il XmlReader può iniziare a copiare i risultati.

count: Int32

Numero massimo di caratteri da copiare nel buffer. Il numero effettivo di caratteri copiati viene restituito da questo metodo.

Restituisce

Task<Int32>

Numero di caratteri letti nel buffer. Quando non è più disponibile contenuto di testo, viene restituito il valore zero.

Eccezioni

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona". -oppure-

È stato chiamato un metodo asincrono della classe XmlReader senza l'impostazione del flag Async su true. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "Per utilizzare i metodi asincroni, impostare XmlReaderSettings.Async su true".

Commenti

Questa è la versione asincrona di ReadValueChunk, con la stessa funzionalità. Per usare questo metodo, è necessario impostare il Async flag su true.

Si applica a