StringReader.ReadLine Método

Definición

Espacio de nombres:

System.IO

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

StringReader.cs

Lee una línea de caracteres de la cadena actual y devuelve los datos como una cadena.

public:
 override System::String ^ ReadLine();

public override string? ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Devoluciones

String

Línea siguiente de la cadena actual o null si se alcanza el final de la cadena.

Excepciones

ObjectDisposedException

El lector actual está cerrado.

OutOfMemoryException

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

Ejemplos

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la StringReader clase .

// From textReaderText, create a continuous paragraph
// with two spaces between each sentence.
string aLine, aParagraph = null;
StringReader strReader = new StringReader(textReaderText);
while(true)
{
    aLine = strReader.ReadLine();
    if(aLine != null)
    {
        aParagraph = aParagraph + aLine + " ";
    }
    else
    {
        aParagraph = aParagraph + "\n";
        break;
    }
}
Console.WriteLine("Modified text:\n\n{0}", aParagraph);

' From textReaderText, create a continuous paragraph 
' with two spaces between each sentence.
Dim aLine, aParagraph As String
Dim strReader As New StringReader(textReaderText)
While True
    aLine = strReader.ReadLine()
    If aLine Is Nothing Then
        aParagraph = aParagraph & vbCrLf
        Exit While
    Else
        aParagraph = aParagraph & aLine & " "
    End If
End While
Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _ 
    aParagraph)

Comentarios

Este método invalida el TextReader.ReadLine método .

Una línea se define como una secuencia de caracteres seguida de una alimentación de línea ("\n"), un retorno de carro ("\r"), un retorno de carro inmediatamente seguido de una fuente de línea ("\r\n"), o el marcador de fin de flujo. 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 marcador de fin de flujo. Es decir, si no hay nada entre la última línea leída y el marcador de fin de flujo, el método devuelve null.

Si la cadena finaliza con una secuencia de nueva línea, no se devuelve ninguna línea vacía adicional. Por ejemplo, la cadena "line1\nline2\n" genera las mismas dos líneas ("line1" y "line2") que la cadena "line1\nline2".

Si el método actual produce una OutOfMemoryException, la posición del lector en la cadena subyacente está avanzada por el número de caracteres que el método pudo leer, pero los caracteres que ya se leen en el búfer interno ReadLine se descartan. Dado que no se puede cambiar la posición del lector en la cadena, los caracteres que ya se leen son irrecuperables y solo se puede acceder a ellos reinicializando .StringReader Para evitar esta situación, use el Read método y almacene los caracteres de lectura en un búfer asignado previamente.

En la tabla siguiente se enumeran ejemplos de otras tareas de E/S típicas o relacionadas.

Para ello...	Vea el ejemplo de este tema...
Cree un archivo de texto.	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto.	Cómo: Escribir texto en un archivo
Lee desde un archivo de texto.	Cómo: Leer texto de un archivo
Anexe texto a un archivo.	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Obtenga el tamaño de un archivo.	FileInfo.Length
Obtiene los atributos de un archivo.	File.GetAttributes
Establezca los atributos de un archivo.	File.SetAttributes
Determine si existe un archivo.	File.Exists
Lee desde un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado
Escribir en un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado

Consulte también

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