TextReader.ReadLine Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.IO.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
System.Runtime.Extensions.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
TextReader.cs
Kaynak:
TextReader.cs
Kaynak:
TextReader.cs

Metin okuyucudan bir karakter satırı okur ve verileri dize olarak döndürür.

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

Döndürülenler

String

Okuyucudan sonraki satır veya null tüm karakterler okunduysa.

Özel durumlar

IOException

Bir G/Ç hatası oluşur.

OutOfMemoryException

Döndürülen dize için arabellek ayırmaya yetecek bellek yok.

ObjectDisposedException

Kapalı TextReader .

ArgumentOutOfRangeException

Sonraki satırdaki karakter sayısı Int32.MaxValue değerinden büyük

Açıklamalar

Satır, ardından satır başı (0x000d), satır beslemesi (0x000a), satır başı ve ardından satır beslemesi veya Environment.NewLineakış sonu işaretçisi gelen karakter dizisi olarak tanımlanır. Döndürülen dize, sonlandırıcı satır dönüşünü veya satır beslemesini içermez. Dönüş değeri, giriş akışının sonuna ulaşıldıysa değeridir null .

Yöntem bir OutOfMemoryException özel durum oluşturursa, okuyucunun temeldeki Stream konumu yöntemin okuyabildiği karakter sayısıyla gelişmiştir, ancak iç ReadLine arabelleğe zaten okunmuş karakterler atılır. Okuyucunun akıştaki konumu değiştirilemediğinden, zaten okunan karakterler kurtarılamaz ve yalnızca nesneyi yeniden başlatarak TextReader erişilebilir. Akış içindeki ilk konum bilinmiyorsa veya akış aramayı desteklemiyorsa, temel alınan Stream konumun da yeniden başlatılması gerekir.

Böyle bir durumdan kaçınmak ve sağlam kod oluşturmak için yöntemini kullanmanız Read ve okuma karakterlerini önceden ayrılmış bir arabellekte depolamanız gerekir.

TextReader sınıfı soyut bir sınıftır. Bu nedenle, kodunuzda örneği oluşturmazsınız. yöntemini kullanma ReadLine örneği için yöntemine StreamReader.ReadLine bakın.

Şunlara uygulanır

Ayrıca bkz.