TextReader.ReadToEnd Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

TextReader.cs

Přečte všechny znaky z aktuální pozice na konec čtečky textu a vrátí je jako jeden řetězec.

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

Návraty

String

Řetězec, který obsahuje všechny znaky z aktuální pozice na konec čtečky textu.

Výjimky

IOException

Dojde k vstupně-výstupní chybě.

ObjectDisposedException

To TextReader je uzavřeno.

OutOfMemoryException

Nedostatek paměti pro přidělení vyrovnávací paměti pro vrácený řetězec.

ArgumentOutOfRangeException

Počet znaků na dalším řádku je větší než Int32.MaxValue

Poznámky

Pokud metoda vyvolá OutOfMemoryException výjimku, pozice čtenáře v podkladovém souboru Stream je rozšířena počtem znaků, které byla metoda schopna přečíst, ale znaky, které jsou již načteny do interní ReadToEnd vyrovnávací paměti, jsou zahozeny. Vzhledem k tomu, že umístění čtečky v datovém proudu nelze změnit, znaky, které už byly přečteny, nejsou obnovitelné a lze k němu přistupovat pouze opětovnou inicializací TextReader. Pokud je počáteční pozice v rámci datového proudu neznámá nebo datový proud nepodporuje hledání, musí se také znovu inicializovat podklad Stream .

Pokud se chcete takové situaci vyhnout a vytvořit robustní kód, měli byste použít metodu Read a uložit znaky čtení do předem nepřiřazené vyrovnávací paměti.

Třída TextReader je abstraktní třída. Proto ji v kódu neodstraňujete. Příklad použití ReadToEnd metody najdete v StreamReader.ReadToEnd metodě.

Viz také

• ReadToEnd()
• ReadToEnd()
• Vstup/výstup souborů a streamů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru