TextReader.ReadLine Método

Definición

Lee una línea de caracteres del lector de texto y devuelve los datos como una cadena.

public:
 virtual System::String ^ ReadLine();
public virtual string ReadLine ();
public virtual string? ReadLine ();
abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string
Public Overridable Function ReadLine () As String

Devoluciones

String

Línea siguiente del lector o null si se han leído todos los caracteres.

Excepciones

Error de E/S.

No hay memoria suficiente para asignar un búfer para la cadena devuelta.

La clase TextReader está cerrada.

El número de caracteres de la línea siguiente es mayor que Int32.MaxValue.

Comentarios

Una línea se define como una secuencia de caracteres seguida de un retorno de carro (0x000d), una fuente de línea (0x000a), un retorno de carro seguido de una fuente de líneas, Environment.NewLineo el marcador de fin de secuencia. La cadena que se devuelve no contiene el retorno de carro de terminación ni la alimentación de línea. El valor devuelto es null si se ha alcanzado el final del flujo de entrada.

Si el método produce una OutOfMemoryException excepción, la posición del lector en el subyacente Stream está avanzada por el número de caracteres que el método pudo leer, pero se descartan los caracteres que ya se leyeron en el búfer interno ReadLine . Dado que no se puede cambiar la posición del lector en la secuencia, los caracteres que ya se leyeron son irrecuperables y solo se puede acceder a ellos reinicializando el TextReader objeto. Si la posición inicial dentro de la secuencia es desconocida o la secuencia no admite la búsqueda, el subyacente Stream también debe reinicializarse.

Para evitar esta situación y generar código sólido, debe usar el Read método y almacenar los caracteres de lectura en un búfer asignado previamente.

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 ReadLine método , vea el StreamReader.ReadLine método .

Se aplica a

Consulte también