TextReader.Read Methode

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.IO.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Liest Daten aus der Textsprachausgabe.

Überlädt

Name	Beschreibung
Read()	Liest das nächste Zeichen aus der Textsprachausgabe und wechselt die Zeichenposition um ein Zeichen.
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 maximale Anzahl von Zeichen aus dem aktuellen Reader und schreibt die Daten in einen Puffer, beginnend am angegebenen Index.

Read()

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Liest das nächste Zeichen aus der Textsprachausgabe und wechselt die Zeichenposition um ein Zeichen.

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 der Textsprachausgabe oder -1, wenn keine weiteren Zeichen verfügbar sind. Die Standardimplementierung gibt -1 zurück.

Ausnahmen

ObjectDisposedException

Das TextReader ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

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

Weitere Informationen

Gilt für:

Read(Span<Char>)

Quelle:: TextReader.cs

Quelle:: TextReader.cs

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>

Wenn diese Methode zurückgegeben wird, enthält sie die angegebene Zeichenspanne, die durch die aus der aktuellen Quelle gelesenen Zeichen ersetzt wird.

Gibt zurück

Int32

Die Anzahl der gelesenen Zeichen. Die Zahl ist kleiner oder gleich der buffer Länge, je nachdem, ob die Daten innerhalb des Lesers verfügbar sind. Diese Methode gibt 0 (Null) zurück, wenn sie aufgerufen wird, wenn keine weiteren Zeichen gelesen werden.

Ausnahmen

ArgumentNullException

buffer ist null.

IOException

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

Gilt für:

Read(Char[], Int32, Int32)

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Quelle:: TextReader.cs

Liest eine angegebene maximale Anzahl von Zeichen aus dem aktuellen Reader und schreibt die Daten in einen Puffer, beginnend am angegebenen Index.

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

Wenn diese Methode zurückgegeben wird, enthält sie das angegebene Zeichenarray mit den Werten zwischen index und (index + count - 1), die durch die aus der aktuellen Quelle gelesenen Zeichen ersetzt werden.

index: Int32

Die Position, an buffer der mit dem Schreiben begonnen werden soll.

count: Int32

Die maximale Anzahl zu lesenden Zeichen. Wenn das Ende des Readers erreicht ist, bevor die angegebene Anzahl von Zeichen in den Puffer gelesen wird, gibt die Methode zurück.

Gibt zurück

Int32

Die Anzahl der gelesenen Zeichen. Die Zahl ist kleiner oder gleich count, je nachdem, ob die Daten innerhalb des Lesers verfügbar sind. Diese Methode gibt 0 (Null) zurück, wenn sie aufgerufen wird, wenn keine weiteren Zeichen gelesen werden.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

ArgumentOutOfRangeException

index oder count ist negativ.

ObjectDisposedException

Das TextReader ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

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

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?