TextReader.Read Methode

  • Referenz

Definition

Namespace:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Liest Daten aus dem Textreader.

Überlädt

Read()

Liest das nächste Zeichen aus dem Text-Reader und verschiebt die Zeichenposition um ein Zeichen nach vorn.
Read(Span<Char>)

Liest die Zeichen aus dem aktuellen Reader und schreibt die Daten in den angegebenen Puffer
Read(Char[], Int32, Int32)

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

Read()

Quelle:
TextReader.cs
Quelle:
TextReader.cs
Quelle:
TextReader.cs

Liest das nächste Zeichen aus dem Text-Reader und verschiebt die Zeichenposition um ein Zeichen nach vorn.

public:
 virtual int Read();
public virtual int Read ();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer

Gibt zurück

Int32

Das nächste Zeichen im Textreader, bzw. -1, wenn keine weiteren Zeichen verfügbar sind. Die Standardimplementierung gibt -1 zurück.

Ausnahmen

ObjectDisposedException

Der TextReader ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die TextReader-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der Read -Methode finden Sie in der StreamReader.Read -Methode.

Weitere Informationen

Gilt für:

Read(Span<Char>)

Quelle:
TextReader.cs
Quelle:
TextReader.cs
Quelle:
TextReader.cs

Liest die Zeichen aus dem aktuellen Reader und schreibt die Daten in den angegebenen Puffer

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

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. Die Anzahl ist kleiner oder gleich der buffer-Länge, abhängig davon, ob die Daten im Reader verfügbar sind. Diese Methode gibt 0 (null) zurück für den Fall, dass sie aufgerufen wird, wenn keine Zeichen mehr zu lesen sind.

Ausnahmen

ArgumentNullException

buffer ist null.

IOException

Die Anzahl der aus dem Datenstrom gelesenen Zeichen ist größer als die Länge des buffer.

Gilt für:

Read(Char[], Int32, Int32)

Quelle:
TextReader.cs
Quelle:
TextReader.cs
Quelle:
TextReader.cs

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

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

Parameter

buffer
Char[]

Enthält nach der Rückgabe 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. Wenn das Ende des Readers erreicht ist, bevor die angegebene Anzahl von Zeichen in den Puffer gelesen wurde, erfolgt die Methodenrückgabe.

Gibt zurück

Int32

Die Anzahl der gelesenen Zeichen. Die Anzahl ist kleiner oder gleich count, abhängig davon, ob die Daten im Reader verfügbar sind. Diese Methode gibt 0 (null) zurück für den Fall, dass sie aufgerufen wird, wenn keine Zeichen mehr zu lesen sind.

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

Diese Methode gibt zurück, nachdem beide count Zeichen gelesen oder das Ende der Datei erreicht wurde. ReadBlock ist eine blockierende Version dieser Methode.

Die TextReader-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht im Code. Ein Beispiel für die Verwendung der Read -Methode finden Sie in der StreamReader.Read -Methode.

Weitere Informationen

Gilt für: