StringReader.ReadLine Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

StringReader.cs

Odczytuje wiersz znaków z bieżącego ciągu i zwraca dane jako ciąg.

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

public override string? ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Zwraca

String

Następny wiersz z bieżącego ciągu lub null jeśli osiągnięto koniec ciągu.

Wyjątki

ObjectDisposedException

Bieżący czytnik jest zamknięty.

OutOfMemoryException

Za mało pamięci do przydzielenia buforu dla zwracanego ciągu.

Przykłady

Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy StringReader.

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

Uwagi

Ta metoda zastępuje metodę TextReader.ReadLine .

Linia jest definiowana jako sekwencja znaków, po której następuje kanał informacyjny ("\n"), powrót karetki ("\r"), powrót karetki bezpośrednio po po którym następuje kanał informacyjny ("\r\n") lub znacznik końca strumienia. Zwracany ciąg nie zawiera powrotu karetki zakończenia ani zestawienia wiersza. Zwrócona wartość to null , jeśli osiągnięto znacznik końca strumienia. Oznacza to, że jeśli nie ma nic między ostatnim wierszem odczytanym a znacznikiem końca strumienia, metoda zwraca wartość null.

Jeśli ciąg kończy się sekwencją nowego wiersza, nie zostanie zwrócony dodatkowy pusty wiersz. Na przykład ciąg "line1\nline2\n" tworzy te same dwa wiersze ("line1" i "line2") jako ciąg "line1\nline2".

Jeśli bieżąca metoda zgłasza błąd OutOfMemoryException, pozycja czytelnika w ciągu bazowym jest zaawansowana przez liczbę znaków, które metoda mogła odczytać, ale znaki już odczytane w buforze wewnętrznym ReadLine są odrzucane. Ponieważ nie można zmienić pozycji czytnika w ciągu, znaki już odczytane są nieodwracalne i można uzyskać do tego dostępu tylko przez ponowne inicjowanie elementu StringReader. Aby uniknąć takiej sytuacji, użyj Read metody i zapisz znaki odczytu w buforze wstępnie alokowanym.

W poniższej tabeli wymieniono przykłady innych typowych lub powiązanych zadań we/wy.

Aby to zrobić...	Zobacz przykład w tym temacie...
Utwórz plik tekstowy.	Instrukcje: zapisywanie tekstu w pliku
Zapisywanie w pliku tekstowym.	Instrukcje: zapisywanie tekstu w pliku
Odczyt z pliku tekstowego.	Instrukcje: odczytywanie tekstu z pliku
Dołączanie tekstu do pliku.	Instrukcje: otwieranie i dołączanie do pliku dziennika File.AppendText FileInfo.AppendText
Pobierz rozmiar pliku.	FileInfo.Length
Pobierz atrybuty pliku.	File.GetAttributes
Ustaw atrybuty pliku.	File.SetAttributes
Ustal, czy plik istnieje.	File.Exists
Odczyt z pliku binarnego.	Instrukcje: odczytywanie i zapisywanie w nowo utworzonym pliku danych
Zapisywanie w pliku binarnym.	Instrukcje: odczytywanie i zapisywanie w nowo utworzonym pliku danych

Zobacz też

• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku