StringReader.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 das nächste Zeichen oder den nächsten Satz von Zeichen aus der Eingabezeichenfolge.

Überlädt

Name	Beschreibung
Read()	Liest das nächste Zeichen aus der Eingabezeichenfolge und wechselt die Zeichenposition um ein Zeichen.
Read(Span<Char>)	Liest alle Zeichen aus der Eingabezeichenfolge ab der aktuellen Position und wechselt zur aktuellen Position zum Ende der Eingabezeichenfolge.
Read(Char[], Int32, Int32)	Liest einen Zeichenblock aus der Eingabezeichenfolge und wechselt die Zeichenposition nach `count`.

Read()

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

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

public:
 override int Read();

public override int Read();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

Gibt zurück

Int32

Das nächste Zeichen aus der zugrunde liegenden Zeichenfolge oder -1, wenn keine weiteren Zeichen verfügbar sind.

Ausnahmen

ObjectDisposedException

Der aktuelle Reader ist geschlossen.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die StringReader Klasse bereitgestellt wird.

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Hinweise

Diese Methode setzt die TextReader.Read Methode außer Kraft.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Um dies zu tun...	Sehen Sie sich das Beispiel in diesem Thema an...
Erstellen Sie eine Textdatei.	Vorgehensweise: Schreiben von Text in eine Datei
In eine Textdatei schreiben	Vorgehensweise: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Vorgehensweise: Lesen von Text aus einer Datei
Anfügen von Text an eine Datei.	Vorgehensweise: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Ruft die Größe einer Datei ab.	FileInfo.Length
Ruft die Attribute einer Datei ab.	File.GetAttributes
Legen Sie die Attribute einer Datei fest.	File.SetAttributes
Ermitteln Sie, ob eine Datei vorhanden ist.	File.Exists
Aus einer Binärdatei lesen.	Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei
Schreiben in eine Binärdatei.	Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei

Weitere Informationen

Gilt für:

Read(Span<Char>)

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Liest alle Zeichen aus der Eingabezeichenfolge ab der aktuellen Position und wechselt zur aktuellen Position zum Ende der Eingabezeichenfolge.

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

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

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

Public Overrides Function Read (buffer As Span(Of Char)) As Integer

Parameter

buffer: Span<Char>

Wenn diese Methode zurückgegeben wird, enthält sie die Zeichen, die aus der aktuellen Quelle gelesen werden. Wenn die Gesamtzahl der gelesenen Zeichen null ist, bleibt die Spanne unverändert.

Gibt zurück

Int32

Die Gesamtzahl der Zeichen, die in den Puffer gelesen werden.

Ausnahmen

ObjectDisposedException

Die aktuelle Zeichenfolgenleserinstanz wird geschlossen.

Gilt für:

Read(Char[], Int32, Int32)

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Quelle:: StringReader.cs

Liest einen Zeichenblock aus der Eingabezeichenfolge und wechselt die Zeichenposition nach count.

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

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

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

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

Der Startindex im Puffer.

count: Int32

Die Anzahl der zu lesenden Zeichen.

Gibt zurück

Int32

Die Gesamtzahl der Zeichen, die in den Puffer gelesen werden. Dies kann kleiner als die Anzahl der angeforderten Zeichen sein, wenn viele Zeichen derzeit nicht verfügbar sind, oder null, wenn das Ende der zugrunde liegenden Zeichenfolge erreicht wurde.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

ArgumentOutOfRangeException

index oder count ist negativ.

ObjectDisposedException

Der aktuelle Reader ist geschlossen.

Hinweise

Diese Methode überschreibt TextReader.Read.

Die Methode liest bis zu count Zeichen aus dem StringReaderbuffer Zeichenarray ab Position index. Gibt die tatsächliche Anzahl der gelesenen Zeichen oder null zurück, wenn das Ende der Zeichenfolge erreicht wurde und keine Zeichen gelesen werden.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Um dies zu tun...	Sehen Sie sich das Beispiel in diesem Thema an...
Erstellen Sie eine Textdatei.	Vorgehensweise: Schreiben von Text in eine Datei
In eine Textdatei schreiben	Vorgehensweise: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Vorgehensweise: Lesen von Text aus einer Datei
Anfügen von Text an eine Datei.	Vorgehensweise: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Ruft die Größe einer Datei ab.	FileInfo.Length
Ruft die Attribute einer Datei ab.	File.GetAttributes
Legen Sie die Attribute einer Datei fest.	File.SetAttributes
Ermitteln Sie, ob eine Datei vorhanden ist.	File.Exists
Aus einer Binärdatei lesen.	Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei
Schreiben in eine Binärdatei.	Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?