Compartir a través de


StringReader.ReadBlockAsync Método

Definición

Sobrecargas

ReadBlockAsync(Memory<Char>, CancellationToken)

Lee de forma asincrónica todos los caracteres de la cadena de entrada, comenzando en la posición actual, y hace avanzar la posición actual hasta el final de la cadena de entrada.

ReadBlockAsync(Char[], Int32, Int32)

Lee de forma asincrónica un número máximo de caracteres especificado en la cadena actual y escribe los datos en un búfer, comenzando en el índice especificado.

ReadBlockAsync(Memory<Char>, CancellationToken)

Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs

Lee de forma asincrónica todos los caracteres de la cadena de entrada, comenzando en la posición actual, y hace avanzar la posición actual hasta el final de la cadena de entrada.

public override System.Threading.Tasks.ValueTask<int> ReadBlockAsync (Memory<char> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.ReadBlockAsync : Memory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadBlockAsync (buffer As Memory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parámetros

buffer
Memory<Char>

Cuando este método devuelve un valor, contiene los caracteres leídos del origen actual. Si el número total de caracteres leídos es cero, el intervalo permanece sin modificar.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Una tarea que representa la operación de lectura asincrónica. El valor del parámetro TResult contiene el número total de bytes leídos en el búfer.

Excepciones

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

ReadBlockAsync(Memory<Char>, CancellationToken) llama ReadBlock(Span<Char>) de forma asincrónica, que a su vez llama Read(Span<Char>) directamente.

Se aplica a

ReadBlockAsync(Char[], Int32, Int32)

Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs

Lee de forma asincrónica un número máximo de caracteres especificado en la cadena actual y escribe los datos en un búfer, comenzando en el índice especificado.

public:
 override System::Threading::Tasks::Task<int> ^ ReadBlockAsync(cli::array <char> ^ buffer, int index, int count);
public override System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<int> ReadBlockAsync (char[] buffer, int index, int count);
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadBlockAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadBlockAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)

Parámetros

buffer
Char[]

Cuando este método devuelve un valor, contiene la matriz de caracteres especificada con valores entre index y (index + count - 1) reemplazada por los caracteres leídos del origen actual.

index
Int32

Lugar de buffer en el que comenzará la escritura.

count
Int32

Número máximo de caracteres que se van a leer. Si el final de la cadena se alcanza antes de escribir el número de caracteres especificado en el búfer, el método vuelve.

Devoluciones

Tarea que representa la operación de lectura asincrónica. El valor del parámetro TResult contiene el número total de bytes leídos en el búfer. El valor del resultado puede ser menor que el número de bytes solicitados si el número de bytes disponibles actualmente es menor que el número solicitado o puede ser 0 (cero) si se ha llegado al final de la cadena.

Atributos

Excepciones

buffer es null.

index o count es negativo.

La suma de index y count es mayor que la longitud del búfer.

El lector de cadenas se ha desechado.

Una operación de lectura anterior está usando actualmente el lector.

Comentarios

La tarea no se completa hasta que se lee el número de caracteres especificados por el count parámetro o se alcanza el final de la cadena.

Se aplica a