StreamReader.ReadBlock Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Überlädt

ReadBlock(Char[], Int32, Int32)	Liest eine angegebene Höchstanzahl von Zeichen aus dem aktuellen Stream 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)

Quelle:

StreamReader.cs

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

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

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

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

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

Parameter

buffer

Char[]

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 StreamReader ist geschlossen.

IOException

E/A-Fehler

Hinweise

Die Position des zugrunde liegenden Datenstroms wird durch die Anzahl der Zeichen erweitert, die in buffergelesen wurden.

Die Methode blockiert, bis beide count Zeichen gelesen werden oder das Ende des Datenstroms erreicht wurde. Dies ist eine blockierende Version von Read.

ReadBlock(Span<Char>)

Quelle:

StreamReader.cs

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

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

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

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

Public Overrides 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