TextReader.ReadToEnd Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Source:

TextReader.cs

Lee todos los caracteres desde la posición actual hasta el final del lector de texto y los devuelve como una cadena.

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

String

Cadena que contiene todos los caracteres desde la posición actual hasta el final del lector.

Excepciones

IOException

Error de E/S.

ObjectDisposedException

La clase TextReader está cerrada.

OutOfMemoryException

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

ArgumentOutOfRangeException

El número de caracteres de la línea siguiente es mayor que Int32.MaxValue.

Comentarios

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 ReadToEnd . 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 .TextReader 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 ReadToEnd método , vea el StreamReader.ReadToEnd método .

Consulte también

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