Freigeben über


StringReader Klasse

Definition

Implementiert einen TextReader, der aus einer Zeichenfolge liest.

public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
[<System.Serializable>]
type StringReader = class
    inherit TextReader
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
Vererbung
StringReader
Vererbung
Attribute

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.

Close()

Schließt TextReader und gibt alle dem TextReader zugeordneten Systemressourcen frei.

(Geerbt von TextReader)
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.

Read(Span<Char>)

Liest die Zeichen aus dem aktuellen Reader und schreibt die Daten in den angegebenen Puffer

(Geerbt von TextReader)
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(Char[], Int32, Int32)

Liest asynchron 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)
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.

ReadAsync(Memory<Char>, CancellationToken)

Liest die Zeichen asynchron aus dem aktuellen Datenstrom in einen Speicherblock.

(Geerbt von TextReader)
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.

ReadBlock(Span<Char>)

Liest die Zeichen aus dem aktuellen Datenstrom und schreibt die Daten in einen Puffer.

(Geerbt von TextReader)
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(Char[], Int32, Int32)

Liest asynchron 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)
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.

ReadBlockAsync(Memory<Char>, CancellationToken)

Liest die Zeichen aus dem aktuellen Datenstrom asynchron und schreibt die Daten in einen Puffer.

(Geerbt von TextReader)
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()

Liest eine Zeile von asynchron Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.

(Geerbt von TextReader)
ReadLineAsync(CancellationToken)

Liest eine Zeile von Zeichen asynchron aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.

ReadLineAsync(CancellationToken)

Liest eine Zeile von asynchron Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.

(Geerbt von TextReader)
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()

Liest alle Zeichen asynchron von der aktuellen Position bis zum Ende des Text-Readers und gibt diese als eine Zeichenfolge zurück.

(Geerbt von TextReader)
ReadToEndAsync(CancellationToken)

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 Text-Readers und gibt diese als eine Zeichenfolge zurück.

(Geerbt von TextReader)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Eine Beschreibung dieses Elements finden Sie unter Dispose().

(Geerbt von TextReader)

Gilt für:

Weitere Informationen