StringReader Klasse

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object

TextReader
StringReader

Vererbung: Object

MarshalByRefObject

TextReader
StringReader

Attribute: SerializableAttribute ComVisibleAttribute

Beispiele

Im folgenden Beispiel wird gezeigt, 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 ihnen, eine Zeichenfolge synchron oder asynchron zu lesen. Sie können ein Zeichen gleichzeitig mit Read der ReadAsync Methode, einer Zeile mit der Methode oder der Methode und einer gesamten Zeichenfolge ReadToEnd mithilfe der ReadLineAsync Methode oder der ReadToEndAsync ReadLine Methode 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).

In der folgenden Tabelle sind Beispiele anderer typischer oder verwandter I/O-Vorgänge aufgeführt.

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
Bestimmen 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