StringReader Klasse

Definition

Namespace:

System.IO

Assembly:

mscorlib.dll

Implementiert ein Element TextReader , das aus einer Zeichenfolge gelesen wird.

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

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Vererbung

Object

MarshalByRefObject

TextReader

StringReader

Attribute

SerializableAttribute ComVisibleAttribute

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 es Ihnen, eine Zeichenfolge synchron oder asynchron zu lesen. Sie können ein Zeichen gleichzeitig mit der Read oder der ReadAsync Methode, einer Zeile mit der Methode oder der ReadLineReadLineAsync Methode und einer ganzen Zeichenfolge mit der ReadToEnd oder der ReadToEndAsync Methode lesen.

Note

Dieser Typ implementiert die IDisposable Schnittstelle, verfügt jedoch nicht über Ressourcen zum Löschen. Dies bedeutet, dass das Direkte Aufrufen von Dispose() oder durch Verwenden eines Sprachkonstrukts wie using (in C#) oder Using (in Visual Basic) nicht erforderlich ist.

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

Konstruktoren

Name	Beschreibung
StringReader(String)	Initialisiert eine neue Instanz der Klasse, die StringReader aus der angegebenen Zeichenfolge liest.

Methoden

Name	Beschreibung
Close()	Schließt die StringReader.
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom TextReader Objekt verwendeten Ressourcen frei. (Geerbt von TextReader)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den StringReader verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der 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, verwendet es jedoch nicht.
Read()	Liest das nächste Zeichen aus der Eingabezeichenfolge und wechselt die Zeichenposition um ein Zeichen.
Read(Char[], Int32, Int32)	Liest einen Zeichenblock aus der Eingabezeichenfolge und wechselt die Zeichenposition nach count.
ReadAsync(Char[], Int32, Int32)	Liest eine angegebene maximale Anzahl von Zeichen aus der aktuellen Zeichenfolge asynchron und schreibt die Daten in einen Puffer, beginnend am angegebenen Index.
ReadBlock(Char[], Int32, Int32)	Liest eine angegebene maximale Anzahl von Zeichen aus dem aktuellen Textleser und schreibt die Daten in einen Puffer, beginnend am angegebenen Index. (Geerbt von TextReader)
ReadBlockAsync(Char[], Int32, Int32)	Liest eine angegebene maximale Anzahl von Zeichen aus der aktuellen Zeichenfolge asynchron und schreibt die Daten in einen Puffer, beginnend am angegebenen Index.
ReadLine()	Liest eine Zeichenzeile aus der aktuellen Zeichenfolge und gibt die Daten als Zeichenfolge zurück.
ReadLineAsync()	Liest asynchron eine Zeichenzeile aus der aktuellen Zeichenfolge und gibt die Daten als Zeichenfolge zurück.
ReadToEnd()	Liest alle Zeichen von der aktuellen Position bis zum Ende der Zeichenfolge und gibt sie als einzelne Zeichenfolge zurück.
ReadToEndAsync()	Liest alle Zeichen von der aktuellen Position bis zum Ende der Zeichenfolge asynchron und gibt sie 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
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei