StreamReader.ReadBlock Methode

Definition

Überlädt

ReadBlock(Span<Char>)

Liest die Zeichen aus dem aktuellen Datenstrom und schreibt die Daten in einen Puffer.Reads the characters from the current stream and writes the data to a buffer.

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.Reads a specified maximum number of characters from the current stream and writes the data to a buffer, beginning at the specified index.

ReadBlock(Span<Char>)

Liest die Zeichen aus dem aktuellen Datenstrom und schreibt die Daten in einen Puffer.Reads the characters from the current stream and writes the data to a buffer.

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 wurdeWhen this method returns, contains the specified span of characters replaced by the characters read from the current source.

Gibt zurück

Int32

Die Anzahl der gelesenen Zeichen.The number of characters that have been read. Abhängig davon, ob alle Eingabezeichen gelesen wurden, ist die Anzahl kleiner oder gleich der Länge buffer.The number will be less than or equal to the buffer length, depending on whether all input characters have been read.

Ausnahmen

buffer ist null.buffer is null.

Der StreamReader ist geschlossen.The StreamReader is closed.

E/A-FehlerAn I/O error occurred.

Gilt für:

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.Reads a specified maximum number of characters from the current stream and writes the data to a buffer, beginning at the specified index.

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[]

Wenn diese Methode zurückgegeben wird, enthält dieser Parameter das angegebene Zeichenarray mit den Werten zwischen index und (index + count –1), die durch die aus der aktuellen Quelle gelesenen Zeichen ersetzt wurden.When this method returns, contains the specified character array with the values between index and (index + count - 1) replaced by the characters read from the current source.

index
Int32

Die Position in buffer, an der mit dem Schreiben begonnen wird.The position in buffer at which to begin writing.

count
Int32

Die maximale Anzahl der zu lesenden Zeichen.The maximum number of characters to read.

Gibt zurück

Int32

Die Anzahl der gelesenen Zeichen.The number of characters that have been read. Die Anzahl ist kleiner oder gleich count, je nachdem, ob alle Eingabezeichen gelesen wurden.The number will be less than or equal to count, depending on whether all input characters have been read.

Ausnahmen

buffer ist null.buffer is null.

Die Pufferlänge minus index ist kleiner als count.The buffer length minus index is less than count.

index oder count ist ein negativer Wert.index or count is negative.

Der StreamReader ist geschlossen.The StreamReader is closed.

E/A-FehlerAn I/O error occurred.

Hinweise

Die Position des zugrunde liegenden Streams wird um die Anzahl der in gelesenen Zeichen erweitert buffer .The position of the underlying stream is advanced by the number of characters that were read into buffer.

Die-Methode wird blockiert count , bis entweder Zeichen gelesen oder das Ende des Streams erreicht wurde.The method blocks until either count characters are read, or the end of the stream has been reached. Dies ist eine blockierende Version von Read .This is a blocking version of Read.

Gilt für: