TextReader.ReadToEnd Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 .