TextReader Klasse

Definition

Namespace:

System.IO

Assembly:

mscorlib.dll

Stellt einen Leser dar, der eine sequenzielle Reihe von Zeichen lesen kann.

public ref class TextReader abstract : MarshalByRefObject, IDisposable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextReader : MarshalByRefObject, IDisposable

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

Public MustInherit Class TextReader
Inherits MarshalByRefObject
Implements IDisposable

Vererbung

Object

MarshalByRefObject

TextReader

Abgeleitet

System.IO.StreamReader

System.IO.StringReader

Attribute

SerializableAttribute ComVisibleAttribute

Implementiert

IDisposable

Beispiele

Die TextReader Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Die StreamReader Klasse wird von einem Datenstrom abgeleitet TextReader und stellt Implementierungen der Member zum Lesen aus einem Datenstrom bereit. Das folgende Beispiel zeigt, wie alle Zeichen in einer Datei mithilfe der StreamReader.ReadAsync(Char[], Int32, Int32) Methode gelesen werden. Sie überprüft, ob jedes Zeichen ein Buchstabe, eine Ziffer oder ein Leerzeichen ist, bevor es einer Instanz der StringBuilder Klasse hinzugefügt wird.

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

namespace WpfApplication
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click_1(object sender, RoutedEventArgs e)
        {
            string filename = @"C:\Example\existingfile.txt";
            char[] result;
            StringBuilder builder = new StringBuilder();

            using (StreamReader reader = File.OpenText(filename))
            {
                result = new char[reader.BaseStream.Length];
                await reader.ReadAsync(result, 0, (int)reader.BaseStream.Length);
            }

            foreach (char c in result)
            {
                if (char.IsLetterOrDigit(c) || char.IsWhiteSpace(c))
                {
                    builder.Append(c);
                }
            }
            FileOutput.Text = builder.ToString();
        }
    }
}

Imports System.Text
Imports System.IO

Class MainWindow

    Private Async Sub Button_Click_1(sender As Object, e As RoutedEventArgs)
        Dim filename As String = "C:\Example\existingfile.txt"
        Dim result() As Char
        Dim builder As StringBuilder = New StringBuilder()

        Using reader As StreamReader = File.OpenText(filename)
            ReDim result(reader.BaseStream.Length)
            Await reader.ReadAsync(result, 0, reader.BaseStream.Length)
        End Using

        For Each c As Char In result
            If (Char.IsLetterOrDigit(c) Or Char.IsWhiteSpace(c)) Then
                builder.Append(c)
            End If
            Next
        FileOutput.Text = builder.ToString()
    End Sub
End Class

Hinweise

TextReader ist die abstrakte Basisklasse von StreamReader und StringReader, die Zeichen aus Datenströmen bzw. Zeichenfolgen lesen. Verwenden Sie diese abgeleiteten Klassen, um eine Textdatei zum Lesen eines angegebenen Zeichenbereichs zu öffnen oder einen Leser basierend auf einem vorhandenen Datenstrom zu erstellen.

Important

Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie alle Typen verwendet haben, die von diesem Typ abgeleitet sind, sollten Sie ihn entweder direkt oder indirekt verwerfen. Rufen Sie die Methode Dispose in einem try/catch-Block auf, um den Typ direkt zu entsorgen. Verwenden Sie zum indirekten Löschen ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie unter Dispose und im Abschnitt "Using an Object that Implements IDisposable" (Verwenden eines Objekts, das IDisposable implementiert) im IDisposable Schnittstellenthema.

Hinweise für Ausführende

Eine abgeleitete Klasse muss die und Read() die Peek() Methoden minimal implementieren, um eine nützliche Instanz von TextReader.

Konstruktoren

Name	Beschreibung
TextReader()	Initialisiert eine neue Instanz der TextReader-Klasse.

Felder

Name	Beschreibung
Null	Stellt keine TextReader Daten bereit, aus der gelesen werden kann.

Methoden

Name	Beschreibung
Close()	Schließt die TextReader systembezogenen TextReaderRessourcen und gibt sie frei.
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.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den TextReader 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()	Liest das nächste Zeichen, ohne den Status des Lesers oder der Zeichenquelle zu ändern. Gibt das nächste verfügbare Zeichen zurück, ohne es tatsächlich vom Leser zu lesen.
Read()	Liest das nächste Zeichen aus der Textsprachausgabe und wechselt die Zeichenposition um ein Zeichen.
Read(Char[], Int32, Int32)	Liest eine angegebene maximale Anzahl von Zeichen aus dem aktuellen Reader und schreibt die Daten in einen Puffer, beginnend am angegebenen Index.
ReadAsync(Char[], Int32, Int32)	Liest eine angegebene maximale Anzahl von Zeichen aus dem aktuellen Textleser 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.
ReadBlockAsync(Char[], Int32, Int32)	Liest eine angegebene maximale Anzahl von Zeichen aus dem aktuellen Textleser asynchron und schreibt die Daten in einen Puffer, beginnend am angegebenen Index.
ReadLine()	Liest eine Zeichenzeile aus der Textsprachausgabe und gibt die Daten als Zeichenfolge zurück.
ReadLineAsync()	Liest asynchron eine Zeichenzeile und gibt die Daten als Zeichenfolge zurück.
ReadToEnd()	Liest alle Zeichen von der aktuellen Position bis zum Ende der Textsprachausgabe und gibt sie als eine Zeichenfolge zurück.
ReadToEndAsync()	Liest alle Zeichen von der aktuellen Position bis zum Ende des Textlesers asynchron und gibt sie als eine Zeichenfolge zurück.
Synchronized(TextReader)	Erstellt einen threadsicheren Wrapper um den angegebenen TextReader.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• StringReader
• StreamReader
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei
• Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei