TextReader.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 Textreader und schreibt die Daten in einen Puffer, wobei am angegebenen Index begonnen wird.Reads a specified maximum number of characters from the current text reader 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:
 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 wurdeWhen this method returns, contains the specified span of characters replaced by the characters read from the current source.

Gibt zurück

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.

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

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.When this method returns, this parameter 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

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 TextReader ist geschlossen.The TextReader is closed.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Die Position des zugrunde liegenden Text Readers wird um die Anzahl der in buffergelesenen Zeichen erweitert.The position of the underlying text reader is advanced by the number of characters that were read into buffer.

Die-Methode wird blockiert, bis entweder count Zeichen gelesen oder alle Zeichen gelesen wurden.The method blocks until either count characters are read, or all characters have been read. Dies ist eine blockierende Version von Read.This is a blocking version of Read.

Siehe auch

Gilt für: