TextReader.ReadBlock Methode

Definition

Namespace:

System.IO

Assembly:

System.IO.dll

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Überlädt

ReadBlock(Char[], Int32, Int32)	Liest eine angegebene Höchstanzahl von Zeichen aus dem aktuellen Textreader und schreibt die Daten in einen Puffer, wobei am angegebenen Index begonnen wird.
ReadBlock(Span<Char>)	Liest die Zeichen aus dem aktuellen Datenstrom und schreibt die Daten in einen Puffer.

ReadBlock(Char[], Int32, Int32)

Liest eine angegebene Höchstanzahl von Zeichen aus dem aktuellen Textreader und schreibt die Daten in einen Puffer, wobei am angegebenen Index begonnen wird.

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

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

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

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

Parameter

buffer

Char[]

Dieser Parameter enthält nach dem Beenden dieser Methode das angegebene Zeichenarray mit den Werten zwischen index und (index + count -1), die durch die aus der aktuellen Quelle gelesenen Zeichen ersetzt wurden.

index

Int32

Die Position in buffer, an der mit dem Schreiben begonnen wird.

count

Int32

Die maximale Anzahl der zu lesenden Zeichen.

Gibt zurück

Int32

Die Anzahl der gelesenen Zeichen. Die Anzahl ist kleiner oder gleich count, je nachdem, ob alle Eingabezeichen gelesen wurden.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

ArgumentOutOfRangeException

index oder count ist ein negativer Wert.

ObjectDisposedException

Der TextReader ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Position des zugrunde liegenden Textlesers wird durch die Anzahl der Zeichen erweitert, die gelesen bufferwurden.

Die Methode blockiert, bis beide count Zeichen gelesen werden oder alle Zeichen gelesen wurden. Dies ist eine blockierte Version von Read.

Siehe auch

• ReadBlock(Char[], Int32, Int32)
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

ReadBlock(Span<Char>)

Liest die Zeichen aus dem aktuellen Datenstrom und schreibt die Daten in einen Puffer.

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

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

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

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

Parameter

buffer

Span<Char>

Enthält nach dem Beenden dieser Methode die angegebene Zeichenspanne, die durch die aus der aktuellen Quelle gelesenen Zeichen ersetzt wurde

Gibt zurück

Int32

Die Anzahl der gelesenen Zeichen. Abhängig davon, ob alle Eingabezeichen gelesen wurden, ist die Anzahl kleiner oder gleich der Länge buffer.

Ausnahmen

ArgumentNullException

buffer ist null.

ObjectDisposedException

Der StreamReader ist geschlossen.

IOException

E/A-Fehler