Freigeben über


StringReader.Read Methode

Definition

Liest das nächste Zeichen oder die nächste Gruppe von Zeichen aus der Eingabezeichenfolge.

Überlädt

Read()

Liest das nächste Zeichen aus der Eingabezeichenfolge und verschiebt die Zeichenposition um ein Zeichen nach vorn.

Read(Span<Char>)

Liest alle Zeichen aus der Eingabezeichenfolge beginnend an der aktuellen Position aus und verschiebt die aktuelle Position an das Ende der Eingabezeichenfolge.

Read(Char[], Int32, Int32)

Liest einen Zeichenblock aus der Eingabezeichenfolge und verschiebt die Zeichenposition um die durch count angegebene Anzahl von Zeichen nach vorn.

Read()

Quelle:
StringReader.cs
Quelle:
StringReader.cs
Quelle:
StringReader.cs

Liest das nächste Zeichen aus der Eingabezeichenfolge und verschiebt die Zeichenposition um ein Zeichen nach vorn.

public:
 override int Read();
public override int Read ();
override this.Read : unit -> int
Public Overrides Function Read () As Integer

Gibt zurück

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

Ausnahmen

Der aktuelle Reader ist geschlossen.

Beispiele

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

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}
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 überschreibt die TextReader.Read -Methode.

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

Aufgabe Siehe das Beispiel in diesem Thema:
Erstellen einer Textdatei How to: Schreiben von Text in eine Datei
Schreiben in eine Textdatei. How to: Schreiben von Text in eine Datei
Aus einer Textdatei lesen. How to: Lesen von Text aus einer Datei
Anfügen von Text an eine Datei. How to: Ö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
Lesen aus einer Binärdatei. How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Schreiben in eine Binärdatei. How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Weitere Informationen

Gilt für:

Read(Span<Char>)

Quelle:
StringReader.cs
Quelle:
StringReader.cs
Quelle:
StringReader.cs

Liest alle Zeichen aus der Eingabezeichenfolge beginnend an der aktuellen Position aus und verschiebt die aktuelle Position an das 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>

Enthält nach Ausführung dieser Methode die aus der aktuellen Quelle gelesenen Zeichen. Wenn die Gesamtzahl der gelesenen Zeichen 0 (null) ist, bleibt die Spanne unverändert.

Gibt zurück

Die Gesamtanzahl der in den Puffer gelesenen Zeichen.

Ausnahmen

Der aktuelle Instanz des Zeichenfolgenlesers ist geschlossen.

Gilt für:

Read(Char[], Int32, Int32)

Quelle:
StringReader.cs
Quelle:
StringReader.cs
Quelle:
StringReader.cs

Liest einen Zeichenblock aus der Eingabezeichenfolge und verschiebt die Zeichenposition um die durch count angegebene Anzahl von Zeichen nach vorn.

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

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

Der Anfangsindex im Puffer.

count
Int32

Die Anzahl der zu lesenden Zeichen.

Gibt zurück

Die Gesamtanzahl der in den Puffer gelesenen Zeichen. Diese kann kleiner als die Anzahl der angeforderten Zeichen sein, wenn diese Anzahl von Zeichen derzeit nicht verfügbar ist, oder 0, wenn das Ende der zugrunde liegenden Zeichenfolge erreicht ist.

Ausnahmen

buffer ist null.

Die Pufferlänge minus index ist kleiner als count.

index oder count ist ein negativer Wert.

Der aktuelle Reader ist geschlossen.

Hinweise

Diese Methode überschreibt TextReader.Read.

Die -Methode liest ab Position indexbis zu count Zeichen aus dem StringReader in das buffer Zeichenarray ein. Gibt die tatsächliche Anzahl der gelesenen Zeichen zurück, oder null, 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.

Aufgabe Siehe das Beispiel in diesem Thema:
Erstellen einer Textdatei How to: Schreiben von Text in eine Datei
Schreiben in eine Textdatei. How to: Schreiben von Text in eine Datei
Aus einer Textdatei lesen. How to: Lesen von Text aus einer Datei
Anfügen von Text an eine Datei. How to: Ö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
Lesen aus einer Binärdatei. How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Schreiben in eine Binärdatei. How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Weitere Informationen

Gilt für: