TextReader.Read Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

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

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

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.

• Read()
• Read()
• Dosya ve Stream G/Ç
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Bir 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 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

ArgumentNullException

buffer, null değeridir.

IOException

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

Read(Char[], Int32, Int32)

Kaynak:

TextReader.cs

Geçerli okuyucudan belirtilen en fazla karakter sayısını okur ve belirtilen dizinden başlayarak verileri 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 (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

Int32

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

ArgumentNullException

buffer, null değeridir.

ArgumentException

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

ArgumentOutOfRangeException

index veya count negatiftir.

ObjectDisposedException

Kapalı TextReader .

IOException

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.

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