TextReader.Read Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

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()

Source:

TextReader.cs

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

ObjectDisposedException

La clase TextReader está cerrada.

IOException

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 de uso del Read método , consulte el StreamReader.Read método .

Consulte también

• Read()
• Read()
• E/S de archivos y secuencias
• Cómo: Leer texto de un archivo
• Cómo: Escribir texto en un archivo

Read(Span<Char>)

Source:

TextReader.cs

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

ArgumentNullException

buffer es null.

IOException

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

Read(Char[], Int32, Int32)

Source:

TextReader.cs

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

ArgumentNullException

buffer es null.

ArgumentException

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

ArgumentOutOfRangeException

index o count es negativo.

ObjectDisposedException

La clase TextReader está cerrada.

IOException

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

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• E/S de archivos y secuencias
• Cómo: Leer texto de un archivo
• Cómo: Escribir texto en un archivo