TextReader.Read Yöntem

Tanım

Metin okuyucudan verileri okur.

Aşırı Yüklemeler

Read()

Metin okuyucudan sonraki karakteri okur ve karakter konumunu bir karakter ilerletir.

Read(Span<Char>)

Geçerli okuyucudaki karakterleri okur ve verileri belirtilen arabelleğe yazar.

Read(Char[], Int32, Int32)

Geçerli okuyucudan belirtilen en fazla karakter sayısını okur ve belirtilen dizinden başlayarak verileri arabelleğe yazar.

Read()

Kaynak:
TextReader.cs
Kaynak:
TextReader.cs
Kaynak:
TextReader.cs

Metin okuyucudan sonraki karakteri okur ve karakter konumunu bir karakter ilerletir.

C#
public virtual int Read ();

Döndürülenler

Metin okuyucudan sonraki karakter veya başka karakter yoksa -1. Varsayılan uygulama -1 döndürür.

Özel durumlar

Bir G/Ç hatası oluşur.

Açıklamalar

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

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Read(Span<Char>)

Kaynak:
TextReader.cs
Kaynak:
TextReader.cs
Kaynak:
TextReader.cs

Geçerli okuyucudaki karakterleri okur ve verileri belirtilen arabelleğe yazar.

C#
public virtual int Read (Span<char> buffer);

Parametreler

buffer
Span<Char>

Bu yöntem döndürdüğünde, geçerli kaynaktan okunan karakterlerle değiştirilen belirtilen karakter aralığını içerir.

Döndürülenler

Okunan karakter sayısı. Verilerin okuyucu içinde kullanılabilir olup olmadığına bağlı olarak, sayı uzunluk değerinden küçük veya buna eşit buffer olacaktır. Bu yöntem, okunacak başka karakter kalmadığında çağrılırsa 0 (sıfır) döndürür.

Özel durumlar

buffer, null değeridir.

Akıştan okunan karakterlerin sayısı, değerinden bufferdaha büyük.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Read(Char[], Int32, Int32)

Kaynak:
TextReader.cs
Kaynak:
TextReader.cs
Kaynak:
TextReader.cs

Geçerli okuyucudan belirtilen en fazla karakter sayısını okur ve belirtilen dizinden başlayarak verileri arabelleğe yazar.

C#
public virtual int Read (char[] buffer, int index, int count);

Parametreler

buffer
Char[]

Bu yöntem döndürdüğünde, ve (index + count - 1) arasındaki index değerlerin geçerli kaynaktan okunan karakterlerle değiştirdiği belirtilen karakter dizisini içerir.

index
Int32

Yazmaya başlayabileceğiniz konum buffer .

count
Int32

Okunacak en fazla karakter sayısı. Belirtilen sayıda karakter arabelleğe okunmadan önce okuyucunun sonuna ulaşılırsa, yöntem döndürür.

Döndürülenler

Okunan karakter sayısı. Sayı, verilerin okuyucu içinde kullanılabilir olup olmadığına bağlı olarak değerinden küçük veya buna eşit countolacaktır. Bu yöntem, okunacak başka karakter kalmadığında çağrılırsa 0 (sıfır) döndürür.

Özel durumlar

buffer, null değeridir.

Arabellek uzunluğu eksi index değeri değerinden countküçüktür.

index veya count negatiftir.

Bir G/Ç hatası oluşur.

Açıklamalar

Bu yöntem, iki karakterden biri count okunduktan veya dosyanın sonuna ulaşıldıktan sonra döndürür. ReadBlock bu yöntemin engelleyici bir sürümüdür.

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

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0