TextReader.ReadLine Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

TextReader.cs

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

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

IOException

Error de E/S.

OutOfMemoryException

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

ObjectDisposedException

La clase TextReader está cerrada.

ArgumentOutOfRangeException

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 .

Consulte también

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