TextReader.Read Método

Definición

Lee datos del lector de texto.Reads data from the text reader.

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.Reads the next character from the text reader and advances the character position by one character.

Read(Span<Char>)
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.Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.

Read()

Lee el siguiente carácter en el lector de texto y hace avanzar la posición de los caracteres en un carácter.Reads the next character from the text reader and advances the character position by one character.

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

Carácter siguiente del lector de texto o -1 si no hay más caracteres disponibles.The next character from the text reader, or -1 if no more characters are available. La implementación predeterminada devuelve -1.The default implementation returns -1.

Excepciones

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

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

Comentarios

La clase TextReader es abstracta.The TextReader class is an abstract class. Por lo tanto, no se crea una instancia de ella en el código.Therefore, you do not instantiate it in your code. Para obtener un ejemplo de cómo Read usar el método, StreamReader.Read vea el método.For an example of using the Read method, see the StreamReader.Read method.

Consulte también:

Read(Span<Char>)

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>

Devoluciones

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.Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.

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.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. Si el final del lector se alcanza antes de escribir el número de caracteres especificado en el búfer, el método vuelve.If the end of the reader is reached before the specified number of characters is read into the buffer, the method returns.

Devoluciones

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, dependiendo de si los datos están disponibles dentro del lector.The number will be less than or equal to count, depending on whether the data is available within the reader. Este método devuelve 0 (cero) si se llama cuando no quedan más caracteres para leer.This method returns 0 (zero) if it is called when no more characters are left to 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 TextReader está cerrada.The TextReader is closed.

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

Comentarios

Este método devuelve después de count leer cualquiera de los caracteres o de llegar al final del archivo.This method returns after either count characters are read or the end of the file is reached. ReadBlockes una versión de bloqueo de este método.ReadBlock is a blocking version of this method.

La clase TextReader es abstracta.The TextReader class is an abstract class. Por lo tanto, no se crea una instancia de ella en el código.Therefore, you do not instantiate it in your code. Para obtener un ejemplo de cómo Read usar el método, StreamReader.Read vea el método.For an example of using the Read method, see the StreamReader.Read method.

Consulte también:

Se aplica a