TextReader.Read Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Metin okuyucudan verileri okur.

Aşırı Yüklemeler

Name	Description
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 verileri belirtilen dizinden başlayarak bir arabelleğe yazar.

Read()

Kaynak:

TextReader.cs

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

public:
 virtual int Read();

public virtual int Read();

abstract member Read : unit -> int
override this.Read : unit -> int

Public Overridable Function Read () As Integer

Döndürülenler

Int32

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

Özel durumlar

ObjectDisposedException

Kapalı TextReader .

IOException

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. Read yöntemini kullanma örneği için StreamReader.Read yöntemine bakın.

Ayrıca bkz.

• Read()
• Read()
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma

Read(Span<Char>)

Kaynak:

TextReader.cs

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

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

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

abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int

Public Overridable Function Read (buffer As Span(Of Char)) As Integer

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

Int32

Okunan karakter sayısı. Verilerin okuyucuda 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 karakter kalmadığında çağrılırsa 0 (sıfır) döndürür.

Özel durumlar

ArgumentNullException

buffer, null'e eşittir.

IOException

Akıştan okunan karakter sayısı, uzunluğundan bufferbüyüktür.

Read(Char[], Int32, Int32)

Kaynak:

TextReader.cs

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

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);

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

abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int

Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Parametreler

buffer

Char[]

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

index

Int32

Yazmaya başlama konumu buffer .

count

Int32

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

Döndürülenler

Int32

Okunan karakter sayısı. Sayı, verilerin okuyucuda kullanılabilir olup olmadığına bağlı olarak değerine eşit countveya ondan küçük olacaktır. Bu yöntem, okunacak karakter kalmadığında çağrılırsa 0 (sıfır) döndürür.

Özel durumlar

ArgumentNullException

buffer, null'e eşittir.

ArgumentException

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

ArgumentOutOfRangeException

index veya count negatiftir.

ObjectDisposedException

Kapalı TextReader .

IOException

G/Ç hatası oluşur.

Açıklamalar

Bu yöntem, karakterler okunduktan veya dosyanın sonuna ulaşıldıktan sonra count 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. Read yöntemini kullanma örneği için StreamReader.Read yöntemine bakın.

Ayrıca bkz.

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma