StringReader.Read Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

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

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

Int32

Das nächste Zeichen in 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 = 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

• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei

Read(Span<Char>)

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

Int32

Die Gesamtanzahl der in den Puffer gelesenen Zeichen.

Ausnahmen

ObjectDisposedException

Der aktuelle Instanz des Zeichenfolgenlesers ist geschlossen.

Read(Char[], Int32, Int32)

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

Int32

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

ArgumentNullException

buffer ist null.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

ArgumentOutOfRangeException

index oder count ist ein negativer Wert.

ObjectDisposedException

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

• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei