TextReader.ReadLine Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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.
Kapalı TextReader .
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.