Sdílet prostřednictvím

TextReader.ReadLine Metoda

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
TextReader.cs
Zdroj:
TextReader.cs
Zdroj:
TextReader.cs

Přečte řádek znaků ze čtečky textu a vrátí data jako řetězec.

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

String

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

Výjimky

IOException

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

OutOfMemoryException

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

ObjectDisposedException

Je TextReader zavřený.

ArgumentOutOfRangeException

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

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é