Udostępnij za pośrednictwem


TextReader.ReadToEnd Metoda

Definicja

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

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

Wyjątki

Wystąpi błąd We/Wy.

Element TextReader jest zamknięty.

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

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 .

Dotyczy

Zobacz też