TextReader.ReadToEnd Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

TextReader.cs

Odczytuje wszystkie znaki z bieżącego położenia na końcu czytnika tekstu i zwraca je jako jeden ciąg.

public:
 virtual System::String ^ ReadToEnd();

public virtual string ReadToEnd ();

abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> string

Public Overridable Function ReadToEnd () As String

Zwraca

String

Ciąg zawierający wszystkie znaki z bieżącej pozycji na końcu czytnika tekstu.

Wyjątki

IOException

Wystąpi błąd We/Wy.

ObjectDisposedException

Element TextReader jest zamknięty.

OutOfMemoryException

Za mało pamięci, aby przydzielić bufor dla zwracanego ciągu.

ArgumentOutOfRangeException

Liczba znaków w następnym wierszu jest większa niż Int32.MaxValue

Uwagi

Jeśli metoda zgłasza OutOfMemoryException wyjątek, pozycja czytelnika w bazie Stream jest zaawansowana przez liczbę znaków, które metoda mogła odczytać, ale znaki, które zostały już odczytane do buforu wewnętrznego ReadToEnd , są odrzucane. Ponieważ nie można zmienić położenia czytnika w strumieniu, znaki, które zostały już odczytane, są nieodwracalne i można uzyskać do nich dostęp tylko przez ponowne inicjowanie elementu TextReader. Jeśli pozycja początkowa w strumieniu jest nieznana lub strumień nie obsługuje wyszukiwania, należy również ponownie zainicjować bazowe Stream .

Aby uniknąć takiej sytuacji i utworzyć niezawodny kod, należy użyć Read metody i zapisać znaki odczytu w buforze wstępnie przydzielonego.

Klasa TextReader jest abstrakcyjną klasą. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia ReadToEnd metody , zobacz metodę StreamReader.ReadToEnd .

Zobacz też

• ReadToEnd()
• ReadToEnd()
• We/Wy pliku i strumienia
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku