StringReader.ReadLine Metod

Definition

Namnområde:

System.IO

Sammansättning:

mscorlib.dll

Läser en rad med tecken från den aktuella strängen och returnerar data som en sträng.

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

public override string ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Returer

String

Nästa rad från den aktuella strängen eller null om slutet av strängen har nåtts.

Undantag

ObjectDisposedException

Den aktuella läsaren är stängd.

OutOfMemoryException

Det finns inte tillräckligt med minne för att allokera en buffert för den returnerade strängen.

Exempel

Det här kodexemplet är en del av ett större exempel för StringReader klassen.

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

Kommentarer

Den här metoden åsidosätter TextReader.ReadLine metoden.

En rad definieras som en sekvens med tecken följt av en radmatning ("\n"), en vagnretur ("\r"), en vagnretur omedelbart följt av en linjematning ("\r\n"), eller markören för slutet av strömmen. Strängen som returneras innehåller inte den avslutande vagnreturen eller radmatningen. Det returnerade värdet är null om markören för slutströmmen har nåtts. Det vill säga, om det inte finns något mellan den sista radläsningen och markören för slutströmmen returnerar nullmetoden .

Om strängen slutar med en ny radsekvens returneras ingen ytterligare tom rad. Strängen "line1\nline2\n" genererar till exempel samma två rader ("line1" och "line2") som strängen "line1\nline2".

Om den aktuella metoden genererar en OutOfMemoryExceptionavanceras läsarens position i den underliggande strängen av antalet tecken som metoden kunde läsa, men tecknen som redan lästs in i den interna ReadLine bufferten ignoreras. Eftersom det inte går att ändra läsarens position i strängen går det inte att återställa de tecken som redan har lästs och kan endast nås genom att initiera om StringReader. Undvik en sådan situation genom att Read använda metoden och lagra lästecken i en förallokerad buffert.

I följande tabell visas exempel på andra typiska eller relaterade I/O-uppgifter.

För att göra det här...	Se exemplet i det här avsnittet...
Skapa en textfil.	Anvisningar: Skriva text till en fil
Skriv till en textfil.	Anvisningar: Skriva text till en fil
Läs från en textfil.	Anvisningar: Läsa text från en fil
Lägg till text i en fil.	Anvisningar: Öppna och lägg till i en loggfil File.AppendText FileInfo.AppendText
Hämta storleken på en fil.	FileInfo.Length
Hämta attributen för en fil.	File.GetAttributes
Ange attributen för en fil.	File.SetAttributes
Kontrollera om det finns en fil.	File.Exists
Läs från en binär fil.	Anvisningar: Läsa och skriva till en nyligen skapad datafil
Skriv till en binär fil.	Anvisningar: Läsa och skriva till en nyligen skapad datafil

Se även

• Fil- och ström-I/O
• Anvisningar: Läsa text från en fil
• Anvisningar: Skriva text till en fil