StreamReader.ReadBlock Método

Definición

Sobrecargas

ReadBlock(Span<Char>)

Lee los caracteres de la secuencia actual y escribe los datos en un búfer.Reads the characters from the current stream and writes the data to a buffer.

ReadBlock(Char[], Int32, Int32)

Lee un número máximo de caracteres especificado en la secuencia actual y escribe los datos en un búfer, comenzando en el índice especificado.Reads a specified maximum number of characters from the current stream and writes the data to a buffer, beginning at the specified index.

ReadBlock(Span<Char>)

Lee los caracteres de la secuencia actual y escribe los datos en un búfer.Reads the characters from the current stream and writes the data to a buffer.

public:
 override int ReadBlock(Span<char> buffer);
public override int ReadBlock (Span<char> buffer);
override this.ReadBlock : Span<char> -> int
Public Overrides Function ReadBlock (buffer As Span(Of Char)) As Integer

Parámetros

buffer
Span<Char>

Cuando este método devuelve un valor, contiene el intervalo especificado de caracteres reemplazados por los caracteres leídos del origen actual.When this method returns, contains the specified span of characters replaced by the characters read from the current source.

Devoluciones

Int32

Número de caracteres que se han leído.The number of characters that have been read. El número será menor o igual que la longitud de buffer, en función de si se han leído todos los caracteres de entrada.The number will be less than or equal to the buffer length, depending on whether all input characters have been read.

Excepciones

buffer es null.buffer is null.

La clase StreamReader está cerrada.The StreamReader is closed.

Error de E/S.An I/O error occurred.

Se aplica a

ReadBlock(Char[], Int32, Int32)

Lee un número máximo de caracteres especificado en la secuencia actual y escribe los datos en un búfer, comenzando en el índice especificado.Reads a specified maximum number of characters from the current stream and writes the data to a buffer, beginning at the specified index.

public:
 override int ReadBlock(cli::array <char> ^ buffer, int index, int count);
public override int ReadBlock (char[] buffer, int index, int count);
override this.ReadBlock : char[] * int * int -> int
Public Overrides Function ReadBlock (buffer As Char(), index As Integer, count As Integer) As Integer

Parámetros

buffer
Char[]

Cuando este método devuelve un valor, contiene la matriz de caracteres especificada con los valores comprendidos entre index y (índice + recuento - 1) reemplazada por los caracteres leídos del origen actual.When this method returns, contains the specified character array with the values between index and (index + count - 1) replaced by the characters read from the current source.

index
Int32

Lugar de buffer en el que comenzará la escritura.The position in buffer at which to begin writing.

count
Int32

Número máximo de caracteres que se van a leer.The maximum number of characters to read.

Devoluciones

Int32

Número de caracteres que se han leído.The number of characters that have been read. Este número será menor o igual que count, en función de si se han leído todos los caracteres de entrada.The number will be less than or equal to count, depending on whether all input characters have been read.

Excepciones

buffer es null.buffer is null.

La longitud del búfer menos index es menor que count.The buffer length minus index is less than count.

index o count es negativo.index or count is negative.

La clase StreamReader está cerrada.The StreamReader is closed.

Error de E/S.An I/O error occurred.

Comentarios

La posición de la secuencia subyacente se avanza por el número de caracteres leídos en buffer .The position of the underlying stream is advanced by the number of characters that were read into buffer.

El método se bloquea hasta que count se leen ambos caracteres o hasta que se alcanza el final de la secuencia.The method blocks until either count characters are read, or the end of the stream has been reached. Se trata de una versión de bloqueo de Read .This is a blocking version of Read.

Se aplica a