StringReader Klasse

Definition

Implementiert einen TextReader, der aus einer Zeichenfolge liest.Implements a TextReader that reads from a string.

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

Im folgenden Beispiel wird gezeigt, wie eine ganze Zeichenfolge asynchron gelesen wird.The following example shows how to read an entire string asynchronously.

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.StringReader enables you to read a string synchronously or asynchronously. Mit der-Methode oder der-Methode können Sie jeweils ein Zeichen lesen Read ReadAsync , indem Sie die ReadLine ReadLineAsync -Methode oder die-Methode verwenden und eine ganze Zeichenfolge mithilfe der- ReadToEnd Methode oder der-Methode verwenden ReadToEndAsync .You can read a character at a time with the Read or the ReadAsync method, a line at a time using the ReadLine or the ReadLineAsync method and an entire string using the ReadToEnd or the ReadToEndAsync method.

Hinweis

Dieser Typ implementiert die IDisposable-Schnittstelle, verfügt aber nicht über löschbare Ressourcen.This type implements the IDisposable interface, but does not actually have any resources to dispose. 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).This means that disposing it by directly calling Dispose() or by using a language construct such as using (in C#) or Using (in Visual Basic) is not necessary.

In der folgenden Tabelle sind Beispiele für andere typische oder Verwandte e/a-Aufgaben aufgeführt.The following table lists examples of other typical or related I/O tasks.

AufgabeTo do this... Siehe das Beispiel in diesem Thema:See the example in this topic...
Erstellen einer TextdateiCreate a text file. How to: Schreiben von Text in eine DateiHow to: Write Text to a File
Schreiben in eine Textdatei.Write to a text file. How to: Schreiben von Text in eine DateiHow to: Write Text to a File
Aus einer Textdatei lesen.Read from a text file. How to: Lesen von Text aus einer DateiHow to: Read Text from a File
Anfügen von Text an eine Datei.Append text to a file. How to: Öffnen und Anfügen an eine ProtokolldateiHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Gibt die Größe einer Datei an.Get the size of a file. FileInfo.Length
Die Attribute einer Datei erhalten.Get the attributes of a file. File.GetAttributes
Legen Sie die Attribute einer Datei fest.Set the attributes of a file. File.SetAttributes
Stellen Sie fest, ob eine Datei vorhanden ist.Determine if a file exists. File.Exists
Lesen aus einer Binärdatei.Read from a binary file. How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte DatendateiHow to: Read and Write to a Newly Created Data File
Schreiben in eine Binärdatei.Write to a binary file. How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte DatendateiHow to: Read and Write to a Newly Created Data File

Konstruktoren

StringReader(String)

Initialisiert eine neue Instanz der StringReader-Klasse, die aus der angegebenen Zeichenfolge liest.Initializes a new instance of the StringReader class that reads from the specified string.

Methoden

Close()

Schließt die StringReader-Klasse.Closes the StringReader.

Close()

Schließt TextReader und gibt alle dem TextReader zugeordneten Systemressourcen frei.Closes the TextReader and releases any system resources associated with the TextReader.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom TextReader-Objekt verwendeten Ressourcen frei.Releases all resources used by the TextReader object.

(Geerbt von TextReader)
Dispose(Boolean)

Gibt die von StringReader verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
Peek()

Gibt das nächste verfügbare Zeichen zurück, ohne es zu verarbeiten.Returns the next available character but does not consume it.

Read()

Liest das nächste Zeichen aus der Eingabezeichenfolge und verschiebt die Zeichenposition um ein Zeichen nach vorn.Reads the next character from the input string and advances the character position by one character.

Read(Char[], Int32, Int32)

Liest einen Zeichenblock aus der Eingabezeichenfolge und verschiebt die Zeichenposition um die durch count angegebene Anzahl von Zeichen nach vorn.Reads a block of characters from the input string and advances the character position by count.

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.Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

Read(Span<Char>)

Liest die Zeichen aus dem aktuellen Reader und schreibt die Daten in den angegebenen PufferReads the characters from the current reader and writes the data to the specified buffer.

(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.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(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.Asynchronously reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

ReadAsync(Memory<Char>, CancellationToken)

Liest die Zeichen asynchron aus dem aktuellen Datenstrom in einen Speicherblock.Asynchronously reads the characters from the current stream into a memory block.

(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.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

(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.Reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlock(Span<Char>)

Liest die Zeichen aus dem aktuellen Datenstrom und schreibt die Daten in einen Puffer.Reads the characters from the current stream and writes the data to a buffer.

(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.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(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.Asynchronously reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlockAsync(Memory<Char>, CancellationToken)

Liest die Zeichen aus dem aktuellen Datenstrom asynchron und schreibt die Daten in einen Puffer.Asynchronously reads the characters from the current stream and writes the data to a buffer.

(Geerbt von TextReader)
ReadLine()

Liest eine Zeile von Zeichen aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.Reads a line of characters from the current string and returns the data as a string.

ReadLineAsync()

Liest eine Zeile von Zeichen asynchron aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.Reads a line of characters asynchronously from the current string and returns the data as a string.

ReadLineAsync()

Liest eine Zeile von asynchron Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.Reads a line of characters asynchronously and returns the data as a string.

(Geerbt von TextReader)
ReadToEnd()

Liest alle Zeichen von der aktuellen Position bis zum Ende des Streams und gibt diese als einzelne Zeichenfolge zurück.Reads all characters from the current position to the end of the string and returns them as a single string.

ReadToEndAsync()

Liest alle Zeichen asynchron von der aktuellen Position bis zum Ende des Streams und gibt diese als einzelne Zeichenfolge zurück.Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.

ReadToEndAsync()

Liest alle Zeichen asynchron von der aktuellen Position bis zum Ende des Text-Readers und gibt diese als eine Zeichenfolge zurück.Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.

(Geerbt von TextReader)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Eine Beschreibung dieses Elements finden Sie unter Dispose().For a description of this member, see Dispose().

(Geerbt von TextReader)

Gilt für:

Siehe auch