TextReader.ReadLine Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> stringPublic Overridable Function ReadLine () As StringDevoluciones
Línea siguiente del lector o null si se han leído todos los caracteres.
Excepciones
Se produce un error de E/S.
No hay memoria suficiente para asignar un búfer para la cadena devuelta.
TextReader Está cerrado.
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ínea, Environment.NewLineo el final de la entrada del lector. La cadena devuelta 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 de la entrada.
Si la entrada finaliza con una secuencia de nueva línea, no se devuelve ninguna línea vacía adicional. Por ejemplo, la entrada que contiene "line1\nline2\n" genera las mismas dos líneas ("line1" y "line2") que la entrada que contiene "line1\nline2".
Si el método produce una OutOfMemoryException excepción, la posición del lector en su origen subyacente 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 la posición del lector en el origen subyacente no se puede restablecer, 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 del origen subyacente es desconocida o el origen no admite la reposición, el origen subyacente 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 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 ReadLine método , vea el StreamReader.ReadLine método .
