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

Definición

Lee asincrónicamente grandes secuencias de texto incrustadas en 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)

Parámetros

buffer
Char[]

Matriz de caracteres que sirve como búfer en el que se escribe el contenido de texto.The array of characters that serves as the buffer to which the text contents are written. Este valor no puede ser null.This value cannot be null.

index
Int32

Desplazamiento en el búfer en el que XmlReader puede empezar a copiar los resultados.The offset within the buffer where the XmlReader can start to copy the results.

count
Int32

Número máximo de caracteres que se van a copiar en el búfer.The maximum number of characters to copy into the buffer. El número real de caracteres copiados se devuelve desde este método.The actual number of characters copied is returned from this method.

Devoluciones

Número de caracteres leídos en el búfer.The number of characters read into the buffer. Si no hay más contenido de texto, se devuelve el valor cero.The value zero is returned when there is no more text content.

Excepciones

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress." O bien-or-

Se llamó un método asincrónico de XmlReader sin establecer la marca Async en true.An XmlReader asynchronous method was called without setting the Async flag to true. En este caso, se produce InvalidOperationException con el mensaje "Establezca XmlReaderSettings.Async en true si quiere usar métodos asincrónicos".In this case, InvalidOperationException is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods."

Comentarios

Esta es la versión asincrónica de ReadValueChunk, con la misma funcionalidad.This is the asynchronous version of ReadValueChunk, with the same functionality. Para usar este método, debe establecer la Async marca en. trueTo use this method, you must set the Async flag to true.

Se aplica a

Consulte también: