TextReader.ReadToEnd TextReader.ReadToEnd TextReader.ReadToEnd TextReader.ReadToEnd Method

Definición

Lee todos los caracteres desde la posición actual hasta el final del lector de texto y los devuelve como una cadena.Reads all characters from the current position to the end of the text reader and returns them as one string.

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

Devoluciones

Cadena que contiene todos los caracteres desde la posición actual hasta el final del lector.A string that contains all characters from the current position to the end of the text reader.

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

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 ReadToEnd 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 ReadToEnd 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 TextReader.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. 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 ReadToEnd usar el método, StreamReader.ReadToEnd vea el método.For an example of using the ReadToEnd method, see the StreamReader.ReadToEnd method.

Se aplica a

Consulte también: