TextReader.ReadLine Metoda

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

public virtual string ReadLine ();

public virtual string? ReadLine ();

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

Public Overridable Function ReadLine () As String

Návraty

Další řádek od čtenáře, nebo null pokud byly přečtené všechny znaky.

Výjimky

Poznámky

Čára je definována jako posloupnost znaků následovaná návratovým znakem řádku (0x000d), 0x000a, návratem řádku následovaným kanálem Environment.NewLineřádku nebo značkou konce datového proudu. Vrácený řetězec neobsahuje ukončující návrat řádku ani kanál řádku. Návratová hodnota je null , pokud bylo dosaženo konce vstupního datového proudu.

Pokud metoda vyvolá OutOfMemoryException výjimku, je pozice čtenáře v podkladovém Stream objektu rozšířena o počet znaků, které byla metoda schopna přečíst, ale znaky, které byly již načteny do interní ReadLine vyrovnávací paměti, jsou zahozeny. Vzhledem k tomu, že umístění čtenáře v datovém proudu nelze změnit, jsou znaky, které byly již přečteny, neopravitelné a lze k nich získat přístup pouze opětovnou inicializací objektu TextReader . Pokud je počáteční pozice v rámci datového proudu neznámá nebo datový proud nepodporuje hledání, je také potřeba 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 přečtené znaky do předem přidělené vyrovnávací paměti.

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

Platí pro

Viz také

• ReadLine()
• ReadLine()
• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru