TextReader.Read Método

Definición

Espacio de nombres:
System.IO
Ensamblados:
mscorlib.dll, System.IO.dll
Ensamblado:
mscorlib.dll
Ensamblado:
System.IO.dll
Ensamblado:
netstandard.dll

Lee los datos del lector de texto.

Sobrecargas

Nombre Description
Read()

Lee el siguiente carácter del lector de texto y avanza la posición del carácter por 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 especificado de caracteres del lector actual y escribe los datos en un búfer, empezando por el índice especificado.

Read()

Lee el siguiente carácter del lector de texto y avanza la posición del carácter por 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

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

Excepciones

ObjectDisposedException

TextReader Está cerrado.

IOException

Se produce un error de E/S.

Comentarios

La TextReader clase 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, contiene el intervalo de caracteres especificado reemplazado por los caracteres leídos del origen actual.

Devoluciones

Int32

Número de caracteres leídos. El número será menor o igual que la buffer longitud, dependiendo 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

ArgumentNullException

buffer es null.

IOException

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

Se aplica a

Read(Char[], Int32, Int32)

Lee un número máximo especificado de caracteres del lector actual y escribe los datos en un búfer, empezando por 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, contiene la matriz de caracteres especificada con los valores entre index y (index + count - 1) reemplazados por los caracteres leídos del origen actual.

index
Int32

Posición en la buffer que se va a empezar a escribir.

count
Int32

Número máximo de caracteres que se van a leer. Si se alcanza el final del lector antes de leer el número especificado de caracteres en el búfer, el método devuelve.

Devoluciones

Int32

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

Excepciones

ArgumentNullException

buffer es null.

ArgumentException

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

ArgumentOutOfRangeException

index o count es negativo.

ObjectDisposedException

TextReader Está cerrado.

IOException

Se produce un 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 TextReader clase 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