TextReader.ReadLine Yöntem

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kodlar:
mscorlib.dll, System.IO.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Runtime.dll
Bütünleştirilmiş Kod:
System.IO.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
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

G/Ç hatası oluşur.

OutOfMemoryException

Döndürülen dize için arabellek ayırmak için yeterli 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 Environment.NewLineveya okuyucu girişinin sonu 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şin sonuna ulaşıldıysa değeridir null .

Giriş yeni bir satır dizisiyle biterse, ek boş satır döndürülür. Örneğin, içeren giriş, içeren "line1\nline2\n" girişle "line1\nline2"aynı iki satırı ("line1" ve "line2") üretir.

Yöntem bir OutOfMemoryException özel durum oluşturursa, okuyucunun temel alınan kaynağındaki konumu yöntemin okuyabildiği karakter sayısıyla gelişmiştir, ancak iç ReadLine arabelleğe zaten okunmuş olan karakterler atılır. Okuyucunun temel alınan kaynaktaki konumu sıfırlanamadığından, zaten okunmuş olan karakterler kurtarılamaz ve yalnızca nesne yeniden başlatılarak TextReader erişilebilir. Temel alınan kaynak içindeki ilk konum bilinmiyorsa veya kaynak yeniden konumlandırmayı desteklemiyorsa, temel alınan kaynağın 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. ReadLine yöntemini kullanma örneği için StreamReader.ReadLine yöntemine bakın.

Şunlara uygulanır

Ayrıca bkz.