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

Definizione

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

Parametri

buffer
Char[]

Matrice di caratteri che funge da buffer in cui viene scritto il contenuto di testo.The array of characters that serves as the buffer to which the text contents are written. Questo valore non può essere null.This value cannot be null.

index
Int32

L'offset all'interno del buffer in cui il XmlReader può iniziare a copiare i risultati.The offset within the buffer where the XmlReader can start to copy the results.

count
Int32

Numero massimo di caratteri da copiare nel buffer.The maximum number of characters to copy into the buffer. Il numero effettivo di caratteri copiati viene restituito da questo metodo.The actual number of characters copied is returned from this method.

Restituisce

Numero di caratteri letti nel buffer.The number of characters read into the buffer. Quando non è più disponibile contenuto di testo, viene restituito il valore zero.The value zero is returned when there is no more text content.

Eccezioni

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress." -oppure--or-

È stato chiamato un metodo asincrono della classe XmlReader senza l'impostazione del flag Async su true.An XmlReader asynchronous method was called without setting the Async flag to true. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "Per utilizzare i metodi asincroni, impostare XmlReaderSettings.Async su true".In this case, InvalidOperationException is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods."

Commenti

Si tratta della versione asincrona di ReadValueChunk, con la stessa funzionalità.This is the asynchronous version of ReadValueChunk, with the same functionality. Per usare questo metodo, è necessario impostare il flag di Async su true.To use this method, you must set the Async flag to true.

Si applica a

Vedi anche