StringReader Klasse

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

StringReader.cs

Implementiert einen TextReader, der aus einer Zeichenfolge liest.

public ref class StringReader : System::IO::TextReader

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Vererbung

Object

MarshalByRefObject

TextReader

StringReader

Beispiele

Das folgende Beispiel zeigt, wie eine gesamte Zeichenfolge asynchron gelesen wird.

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            StringBuilder stringToRead = new StringBuilder();
            stringToRead.AppendLine("Characters in 1st line to read");
            stringToRead.AppendLine("and 2nd line");
            stringToRead.AppendLine("and the end");

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                string readText = await reader.ReadToEndAsync();
                Console.WriteLine(readText);
            }
        }
    }
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = New StringBuilder()
        stringToRead.AppendLine("Characters in 1st line to read")
        stringToRead.AppendLine("and 2nd line")
        stringToRead.AppendLine("and the end")

        Using reader As StringReader = New StringReader(stringToRead.ToString())
            Dim readText As String = Await reader.ReadToEndAsync()
            Console.WriteLine(readText)
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

Hinweise

StringReader ermöglicht das synchrone oder asynchrone Lesen einer Zeichenfolge. Sie können ein Zeichen gleichzeitig mit der ReadReadAsync -Methode oder, eine Zeile mit der ReadLine -Methode oder ReadLineAsync und eine gesamte Zeichenfolge mit der ReadToEnd -Methode oder ReadToEndAsync lesen.

Hinweis

Dieser Typ implementiert die IDisposable-Schnittstelle, verfügt aber nicht über löschbare Ressourcen. Dies bedeutet, dass es nicht nötig ist, ihn zu löschen, indem Sie Dispose() direkt aufrufen, oder indem Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic).

Die folgende Tabelle enthält Beispiele für andere typische oder verwandte E/A-Aufgaben.

Aufgabe	Siehe das Beispiel in diesem Thema:
Erstellen einer Textdatei	How to: Schreiben von Text in eine Datei
Schreiben Sie in eine Textdatei.	How to: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	How to: Lesen von Text aus einer Datei
Fügen Sie Text an eine Datei an.	How to: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Rufen Sie die Größe einer Datei ab.	FileInfo.Length
Rufen Sie 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.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Schreiben Sie in eine Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Konstruktoren

StringReader(String)

Initialisiert eine neue Instanz der StringReader-Klasse, die aus der angegebenen Zeichenfolge liest.

Methoden

Close()	Schließt die StringReader-Klasse.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom TextReader-Objekt verwendeten Ressourcen frei. (Geerbt von TextReader)
Dispose(Boolean)	Gibt die von StringReader verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
Peek()	Gibt das nächste verfügbare Zeichen zurück, ohne es zu verarbeiten.
Read()	Liest das nächste Zeichen aus der Eingabezeichenfolge und verschiebt die Zeichenposition um ein Zeichen nach vorn.
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(Span<Char>)	Liest alle Zeichen aus der Eingabezeichenfolge beginnend an der aktuellen Position aus und verschiebt die aktuelle Position an das Ende der Eingabezeichenfolge.
ReadAsync(Char[], Int32, Int32)	Liest eine angegebene Höchstanzahl von Zeichen asynchron aus der aktuellen Zeichenkette und schreibt die Daten in einen Puffer, wobei am angegebenen Index begonnen wird.
ReadAsync(Memory<Char>, CancellationToken)	Liest asynchron alle Zeichen aus der Eingabezeichenfolge beginnend an der aktuellen Position und verschiebt die aktuelle Position an das Ende der Eingabezeichenfolge.
ReadBlock(Char[], Int32, Int32)	Liest eine angegebene Höchstanzahl von Zeichen aus dem aktuellen Textreader und schreibt die Daten in einen Puffer, wobei am angegebenen Index begonnen wird. (Geerbt von TextReader)
ReadBlock(Span<Char>)	Liest alle Zeichen aus der Eingabezeichenfolge beginnend an der aktuellen Position und verschiebt die aktuelle Position an das Ende der Eingabezeichenfolge.
ReadBlockAsync(Char[], Int32, Int32)	Liest eine angegebene Höchstanzahl von Zeichen asynchron aus der aktuellen Zeichenkette und schreibt die Daten in einen Puffer, wobei am angegebenen Index begonnen wird.
ReadBlockAsync(Memory<Char>, CancellationToken)	Liest alle Zeichen aus der Eingabezeichenfolge beginnend an der aktuellen Position und verschiebt die aktuelle Position an das Ende der Eingabezeichenfolge.
ReadLine()	Liest eine Zeile von Zeichen aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.
ReadLineAsync()	Liest eine Zeile von Zeichen asynchron aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.
ReadLineAsync(CancellationToken)	Liest eine Zeile von Zeichen asynchron aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.
ReadToEnd()	Liest alle Zeichen von der aktuellen Position bis zum Ende des Streams und gibt diese als einzelne Zeichenfolge zurück.
ReadToEndAsync()	Liest alle Zeichen asynchron von der aktuellen Position bis zum Ende des Streams und gibt diese als einzelne Zeichenfolge zurück.
ReadToEndAsync(CancellationToken)	Liest alle Zeichen asynchron von der aktuellen Position bis zum Ende des Streams und gibt diese als einzelne Zeichenfolge zurück.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

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