StringReader.ReadLine Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

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, aby przydzielić bufor dla zwracanego ciągu.

Przykłady

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

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

Uwagi

Ta metoda zastępuje metodę TextReader.ReadLine .

Wiersz jest definiowany jako sekwencja znaków, po której następuje źródło wiersza ("\n"), znak powrotu karetki ("\r"), powrót karetki bezpośrednio po znaku linii ("\r\n") lub znacznik końca strumienia. Zwracany ciąg nie zawiera powrotu karetki zakończenia ani przesuwu 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 odczytu a znacznikiem końca strumienia, metoda zwraca wartość null.

Jeśli bieżąca metoda zgłasza OutOfMemoryExceptionbłąd , pozycja czytnika 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 mogą być dostępne tylko przez ponowne inicjowanie StringReaderelementu . Aby uniknąć takiej sytuacji, należy użyć Read metody i zapisać znaki odczytu w buforze z prelokowanym przydziałem.

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

Aby wykonać tę czynność...	Zobacz przykład w tym temacie...
Twórca pliku tekstowego.	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 pliku dziennika i dołączanie do niego 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: Odczyt i zapis we właśnie utworzonym pliku danych
Zapisywanie w pliku binarnym.	Instrukcje: Odczyt i zapis we właśnie utworzonym pliku danych

Zobacz też

• We/wy plików i Stream
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku