StringReader.ReadLine Methode

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

public override string ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Retouren

De volgende regel van de huidige tekenreeks of null als het einde van de tekenreeks is bereikt.

Uitzonderingen

Voorbeelden

Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de StringReader klasse.

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

Opmerkingen

Met deze methode wordt de TextReader.ReadLine methode overschreven.

Een regel wordt gedefinieerd als een reeks tekens gevolgd door een regelinvoer ("\n"), een regelterugloop ("\r"), een regelterugloop direct gevolgd door een regelinvoer ("\r\n") of de markering voor het einde van de stroom. De tekenreeks die wordt geretourneerd, bevat niet de retour- of regelinvoer voor het einde van het regelterugloop. De geretourneerde waarde is null als het einde van de stroommarkering is bereikt. Dat wil zeggen, als er niets is tussen de laatste regel die wordt gelezen en de einde van de stroommarkering, retourneert nullde methode .

Als de tekenreeks eindigt op een nieuwe regel, wordt er geen extra lege regel geretourneerd. De tekenreeks "line1\nline2\n" produceert bijvoorbeeld dezelfde twee regels ("line1" en "line2") als de tekenreeks "line1\nline2".

Als de huidige methode een OutOfMemoryExceptionwaarde genereert, wordt de positie van de lezer in de onderliggende tekenreeks geavanceerd door het aantal tekens dat de methode kon lezen, maar de tekens die al in de interne ReadLine buffer zijn gelezen, worden verwijderd. Omdat de positie van de lezer in de tekenreeks niet kan worden gewijzigd, zijn de tekens die al zijn gelezen, onherstelbaar en kunnen ze alleen worden geopend door het StringReaderopnieuw te initialiseren. Als u een dergelijke situatie wilt voorkomen, gebruikt u de Read methode en slaat u de leestekens op in een vooraf toegewezen buffer.

De volgende tabel bevat voorbeelden van andere typische of gerelateerde I/O-taken.

Zie ook

• Bestands- en Stream-I/O
• Procedure: Tekst uit een bestand lezen
• Procedure: Tekst naar een bestand schrijven