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
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 .
