TextReader Osztály

Definíció

Névtér:

System.IO

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

TextReader.cs

Olyan olvasót jelöl, amely képes sorozatos karakterek olvasására.

public ref class TextReader abstract : MarshalByRefObject, IDisposable

public abstract class TextReader : MarshalByRefObject, IDisposable

type TextReader = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TextReader
Inherits MarshalByRefObject
Implements IDisposable

Öröklődés

Object

MarshalByRefObject

TextReader

Származtatott

System.IO.StreamReader

System.IO.StringReader

Megvalósítás

IDisposable

Példák

Az TextReader osztály egy absztrakt osztály. Ezért nem példányosíthatja azt a kódban. Az StreamReader osztály a tagoktól származik TextReader , és implementációkat biztosít a streamből való olvasáshoz. Az alábbi példa bemutatja, hogyan olvashatja be a fájl összes karakterét a StreamReader.ReadAsync(Char[], Int32, Int32) metódus használatával. Ellenőrzi, hogy minden karakter betű, számjegy vagy fehér terület-e, mielőtt hozzáadja a karaktert az StringBuilder osztály egy példányához.

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

Megjegyzések

TextReadera streamekből és StreamReadersztringekből beolvasott karakterek absztrakt alaposztályaStringReader. Ezekkel a származtatott osztályokkal megnyithat egy szövegfájlt egy megadott karaktertartomány olvasásához, vagy létrehozhat egy olvasót egy meglévő stream alapján.

Important

Ez a típus implementálja a IDisposable felületet. Ha befejezte az ebből a típusból származó bármely típus használatát, közvetlenül vagy közvetve kell megsemmisítenie azt. A típus közvetlen ártalmatlanításához hívja meg a Dispose metódust egy try/catch blokkban. Ha közvetve szeretné megsemmisíteni, használjon olyan nyelvi szerkezetet, mint a using (C#-ban) vagy Using (a Visual Basicben). További információkért tekintse meg az Elidegenítés és az "IDisposable-t megvalósító objektum használata" című szakaszt a IDisposable felület témakörében.

Megjegyzések az implementálókhoz

A származtatott osztálynak minimálisan végre kell hajtania azokat a Peek() metódusokat és Read() metódusokat, amelyekből hasznos példányt TextReaderhozhat létre.

Konstruktorok

Name	Description
TextReader()	Inicializálja a TextReader osztály új példányát.

Mezők

Name	Description
Null	TextReader Nem tartalmaz olvasási adatokat.

Metódusok

Name	Description
Close()	Bezárja és felszabadítja a TextReader .-hoz társított rendszererőforrásokat TextReader.
Dispose()	Felszabadítja az objektum által használt összes erőforrást TextReader .
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által TextReader használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Elavult. Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Elavult. Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
Peek()	Beolvassa a következő karaktert az olvasó vagy a karakterforrás állapotának módosítása nélkül. A következő elérhető karaktert adja vissza anélkül, hogy ténylegesen felolvassa az olvasótól.
Read()	Beolvassa a következő karaktert a szövegolvasóból, és a karakter pozícióját egy karakterre előrelépteti.
Read(Char[], Int32, Int32)	Beolvassa a megadott számú karaktert az aktuális olvasóból, és a megadott indextől kezdve egy pufferbe írja az adatokat.
Read(Span<Char>)	Beolvassa a karaktereket az aktuális olvasóból, és az adatokat a megadott pufferbe írja.
ReadAsync(Char[], Int32, Int32)	Beolvassa a megadott maximális számú karaktert az aktuális szövegolvasóból aszinkron módon, és a megadott indextől kezdődően egy pufferbe írja az adatokat.
ReadAsync(Memory<Char>, CancellationToken)	Aszinkron módon beolvassa a karaktereket az aktuális streamből egy memóriablokkba.
ReadBlock(Char[], Int32, Int32)	Beolvassa a megadott számú karaktert az aktuális szövegolvasóból, és a megadott indextől kezdve egy pufferbe írja az adatokat.
ReadBlock(Span<Char>)	Beolvassa a karaktereket az aktuális streamből, és egy pufferbe írja az adatokat.
ReadBlockAsync(Char[], Int32, Int32)	Beolvassa a megadott maximális számú karaktert az aktuális szövegolvasóból aszinkron módon, és a megadott indextől kezdődően egy pufferbe írja az adatokat.
ReadBlockAsync(Memory<Char>, CancellationToken)	Aszinkron módon beolvassa a karaktereket az aktuális adatfolyamból, és egy pufferbe írja az adatokat.
ReadLine()	Beolvas egy karaktersort a szövegolvasóból, és sztringként adja vissza az adatokat.
ReadLineAsync()	Egy karaktersort aszinkron módon olvas be, és sztringként adja vissza az adatokat.
ReadLineAsync(CancellationToken)	Egy karaktersort aszinkron módon olvas be, és sztringként adja vissza az adatokat.
ReadToEnd()	Beolvassa az összes karaktert az aktuális pozíciótól a szövegolvasó végéig, és egy sztringként adja vissza őket.
ReadToEndAsync()	Beolvassa az összes karaktert az aktuális pozíciótól a szövegolvasó végéig aszinkron módon, és egy sztringként adja vissza őket.
ReadToEndAsync(CancellationToken)	Beolvassa az összes karaktert az aktuális pozíciótól a szövegolvasó végéig aszinkron módon, és egy sztringként adja vissza őket.
Synchronized(TextReader)	Szálbiztos burkolót hoz létre a megadott TextReaderkörül.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• StringReader
• StreamReader
• Fájl és folyam I/O
• Útmutató: Szöveg beolvasása fájlból
• Útmutató: Szöveg írása fájlba
• Útmutató: Olvasás és írás újonnan létrehozott adatfájlba