TextReader.ReadLine Yöntem

Tanım

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

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

Özel durumlar

Bir G/Ç hatası oluşur.

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

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.