StringReader.ReadLine Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

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

Restituisce

String

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

Eccezioni

ObjectDisposedException

Il lettore corrente è chiuso.

OutOfMemoryException

La memoria disponibile non è sufficiente per l’allocazione di 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;
String^ aParagraph;
StringReader^ strReader = gcnew StringReader( textReaderText );
while ( true )
{
   aLine = strReader->ReadLine();
   if ( aLine != nullptr )
   {
      aParagraph = String::Concat( aParagraph, aLine,  " " );
   }
   else
   {
      aParagraph = String::Concat( aParagraph,  "\n" );
      break;
   }
}

Console::WriteLine(  "Modified text:\n\n{0}", aParagraph );

// 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 l'avanzamento 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 il metodo corrente genera un'eccezione OutOfMemoryException, la posizione del lettore nella stringa sottostante viene 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é non è possibile modificare la posizione del lettore nella stringa, i caratteri già letti sono irreversibili e possono essere accessibili solo reinizializzando .StringReader Per evitare tale situazione, usare il Read metodo e archiviare i caratteri letti in un buffer preallocato.

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

Per eseguire questa operazione...	Vedere l'esempio riportato in questo argomento...
Creare un file di testo.	Procedura: Scrivere un testo in un file
Scrivere in un file di testo.	Procedura: Scrivere un testo in un file
Leggere da un file di testo.	Procedura: Leggere testo da un file
Aggiungere testo a un file.	Procedura: Aprire e accodare un file di log File.AppendText FileInfo.AppendText
Ottenere le dimensioni di un file.	FileInfo.Length
Ottiene 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 su un file di dati appena creato
Scrivere in un file binario.	Procedura: Leggere e scrivere su un file di dati appena creato

Vedi anche

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