StringReader.ReadLine Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

netstandard.dll, System.Runtime.dll

Origine:

StringReader.cs

Legge una riga di caratteri dalla stringa corrente e restituisce i dati come stringa.

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

public override string? ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Valori restituiti

String

Riga successiva dalla stringa corrente o null se viene raggiunta la fine della stringa.

Eccezioni

ObjectDisposedException

Il lettore corrente è chiuso.

OutOfMemoryException

Memoria insufficiente per allocare un buffer per la stringa restituita.

Esempio

Questo esempio di codice fa parte di un esempio più ampio fornito per la StringReader classe .

// 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)

Commenti

Questo metodo esegue l'override del TextReader.ReadLine metodo .

Una riga è definita come una sequenza di caratteri seguita da un avanzamento riga ("\n"), un ritorno a capo ("\r"), un ritorno a capo immediatamente seguito da un avanzamento riga ("\r\n") o dall'indicatore di fine flusso. La stringa restituita non contiene il ritorno a capo finale o il feed di riga. Il valore restituito è null se è stato raggiunto l'indicatore di fine flusso. Ciò significa che, se non c'è nulla tra l'ultima riga letta e l'indicatore di fine flusso, il metodo restituisce null.

Se la stringa termina con una sequenza di nuova riga, non viene restituita alcuna riga vuota aggiuntiva. Ad esempio, la stringa "line1\nline2\n" produce le stesse due righe ("line1" e "line2") della stringa "line1\nline2".

Se il metodo corrente genera un ' OutOfMemoryException, la posizione del lettore nella stringa sottostante è avanzata dal numero di caratteri che il metodo è stato in grado di leggere, ma i caratteri già letti nel buffer interno ReadLine vengono eliminati. Poiché la posizione del lettore nella stringa non può essere modificata, i caratteri già letti sono irreversibili e possono essere accessibili solo reinizializzando .StringReader Per evitare una situazione di questo tipo, usare il Read metodo e archiviare i caratteri di lettura in un buffer preallocato.

Nella tabella seguente sono elencati esempi di altre attività di I/O tipiche o correlate.

Per eseguire questa operazione...	Consulta l'esempio in questo argomento...
Creare un file di testo.	Procedura: Scrivere testo in un file
Scrivere in un file di testo.	Procedura: Scrivere testo in un file
Leggere da un file di testo.	Procedura: Leggere testo da un file
Aggiungere testo a un file.	Procedura: Aprire e aggiungere a un file di log File.AppendText FileInfo.AppendText
Ottenere le dimensioni di un file.	FileInfo.Length
Ottenere gli attributi di un file.	File.GetAttributes
Impostare gli attributi di un file.	File.SetAttributes
Determinare se esiste un file.	File.Exists
Leggere da un file binario.	Procedura: Leggere e scrivere in un file di dati appena creato
Scrivere in un file binario.	Procedura: Leggere e scrivere in un file di dati appena creato

Vedi anche

• I/O di file e di flussi
• Procedura: Leggere testo da un file
• Procedura: Scrivere testo in un file