TextReader.ReadLine TextReader.ReadLine TextReader.ReadLine TextReader.ReadLine Method

Definición

Lee una línea de caracteres del lector de texto y devuelve los datos como una cadena.Reads a line of characters from the text reader and returns the data as a string.

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

Línea siguiente del lector o null si se han leído todos los caracteres.The next line from the reader, or null if all characters have been read.

Excepciones

Error de E/S.An I/O error occurs.

No hay memoria suficiente para asignar un búfer para la cadena devuelta.There is insufficient memory to allocate a buffer for the returned string.

El número de caracteres de la siguiente línea es mayor que MaxValueThe number of characters in the next line is larger than MaxValue

Comentarios

Una línea se define como una secuencia de caracteres seguida de un retorno de carro (0x000d), un salto de línea (0x000a), un retorno de carro seguido de un Environment.NewLinesalto de línea, o el marcador de fin de flujo.A line is defined as a sequence of characters followed by a carriage return (0x000d), a line feed (0x000a), a carriage return followed by a line feed, Environment.NewLine, or the end-of-stream marker. La cadena que se devuelve no contiene el retorno de carro o el avance de línea de terminación.The string that is returned does not contain the terminating carriage return or line feed. El valor devuelto null es si se ha alcanzado el final del flujo de entrada.The return value is null if the end of the input stream has been reached.

Si el método produce una OutOfMemoryException excepción, la posición del lector en el subyacente Stream se avanza por el número de caracteres que el método pudo leer, pero los caracteres que ya se leyeron en el búfer interno ReadLine son descartan.If the method throws an OutOfMemoryException exception, the reader's position in the underlying Stream is advanced by the number of characters the method was able to read, but the characters that were already read into the internal ReadLine buffer are discarded. Dado que no se puede cambiar la posición del lector en la secuencia, los caracteres ya leídos son irrecuperables y solo se puede tener acceso a ellos reinicializando el TextReader objeto.Because the position of the reader in the stream cannot be changed, the characters that were already read are unrecoverable and can be accessed only by reinitializing the TextReader object. Si se desconoce la posición inicial dentro de la secuencia o si la secuencia no admite búsquedas, Stream el subyacente también debe reinicializarse.If the initial position within the stream is unknown or the stream does not support seeking, the underlying Stream also needs to be reinitialized.

Para evitar este tipo de situación y generar código sólido, debe usar Read el método y almacenar los caracteres de lectura en un búfer preasignado.To avoid such a situation and produce robust code you should use the Read method and store the read characters in a preallocated buffer.

La clase TextReader es abstracta.The TextReader class is an abstract class. Por lo tanto, no se crea una instancia de ella en el código.Therefore, you do not instantiate it in your code. Para obtener un ejemplo de cómo ReadLine usar el método, StreamReader.ReadLine vea el método.For an example of using the ReadLine method, see the StreamReader.ReadLine method.

Se aplica a

Consulte también: