TextReader.Read Método

Definición

Lee datos del lector de texto.

Sobrecargas

Read()

Lee el siguiente carácter en el lector de texto y hace avanzar la posición de los caracteres en un carácter.

Read(Span<Char>)

Lee los caracteres del lector actual y escribe los datos en el búfer especificado.

Read(Char[], Int32, Int32)

Lee un número máximo de caracteres especificado en el lector actual y escribe los datos en un búfer, comenzando en el índice especificado.

Read()

Lee el siguiente carácter en el lector de texto y hace avanzar la posición de los caracteres en un carácter.

public:
 virtual int Read();
public virtual int Read ();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer

Devoluciones

Int32

Carácter siguiente del lector de texto o -1 si no hay más caracteres disponibles. La implementación predeterminada devuelve -1.

Excepciones

La clase TextReader está cerrada.

Error de E/S.

Comentarios

La clase TextReader es una clase abstracta. Por lo tanto, no se crea una instancia en el código. Para obtener un ejemplo del uso del Read método , vea el StreamReader.Read método .

Consulte también

Se aplica a

Read(Span<Char>)

Lee los caracteres del lector actual y escribe los datos en el búfer especificado.

public:
 virtual int Read(Span<char> buffer);
public virtual int Read (Span<char> buffer);
abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int
Public Overridable Function Read (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.

Devoluciones

Int32

Número de caracteres que se han leído. El número será menor o igual que la longitud de buffer, en función de si los datos están disponibles dentro del lector. Este método devuelve 0 (cero) si se llama cuando no quedan más caracteres para leer.

Excepciones

buffer es null.

El número de caracteres leídos de la secuencia es mayor que la longitud de buffer.

Se aplica a

Read(Char[], Int32, Int32)

Lee un número máximo de caracteres especificado en el lector actual y escribe los datos en un búfer, comenzando en el índice especificado.

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);
public virtual int Read (char[] buffer, int index, int count);
abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int
Public Overridable Function Read (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 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 del lector se alcanza antes de escribir el número de caracteres especificado en el búfer, el método vuelve.

Devoluciones

Int32

Número de caracteres que se han leído. Este número será menor o igual que count, en función de si los datos están disponibles dentro del lector. Este método devuelve 0 (cero) si se llama cuando no quedan más caracteres para leer.

Excepciones

buffer es null.

La longitud del búfer menos index es menor que count.

index o count es negativo.

La clase TextReader está cerrada.

Error de E/S.

Comentarios

Este método devuelve una vez leídos los count caracteres o se alcanza el final del archivo. ReadBlock es una versión de bloqueo de este método.

La clase TextReader es una clase abstracta. Por lo tanto, no se crea una instancia en el código. Para obtener un ejemplo de uso del Read método , consulte el StreamReader.Read método .

Consulte también

Se aplica a