TextReader Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

TextReader.cs

Sıralı bir karakter dizisini okuyabilen bir okuyucudur.

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

Devralma

Object

MarshalByRefObject

TextReader

Türetilmiş

System.IO.StreamReader

System.IO.StringReader

Uygulamalar

IDisposable

Örnekler

TextReader sınıfı soyut bir sınıftır. Bu nedenle, kodunuzda örneği oluşturmazsınız. StreamReader sınıfı öğesinden TextReader türetilir ve bir akıştan okumak için üyelerin uygulamalarını sağlar. Aşağıdaki örnekte, yöntemini kullanarak bir dosyadaki tüm karakterlerin nasıl okunduğu gösterilmektedir StreamReader.ReadAsync(Char[], Int32, Int32) . Sınıfın bir örneğine StringBuilder karakteri eklemeden önce her karakterin bir harf, rakam veya boşluk olup olmadığını denetler.

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

Açıklamalar

TextReader, sırasıyla akışlardan ve dizelerden karakterleri okuyan ve StringReaderöğesinin soyut temel sınıfıdırStreamReader. Belirtilen karakter aralığını okumak üzere bir metin dosyası açmak veya var olan bir akışı temel alan bir okuyucu oluşturmak için bu türetilmiş sınıfları kullanın.

Önemli

Bu tür arabirimini IDisposable uygular. Bu türden türetilen herhangi bir türü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atmak için yöntemini bir try/catch blok içinde çağırın.Dispose Bunu dolaylı olarak atmak için (C#'de) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanın. Daha fazla bilgi için dispose bölümüne ve arabirim konusunun "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne IDisposable bakın.

Uygulayanlara Notlar

Türetilmiş bir sınıf, kullanışlı bir örneğini TextReaderoluşturmak için ve Read() yöntemlerini en az uygulamalıdırPeek().

Oluşturucular

TextReader()

TextReader sınıfının yeni bir örneğini başlatır.

Alanlar

Null	Okunacak veri içermeyen bir TextReader sağlar.

Yöntemler

Close()	öğesini TextReader kapatır ve ile TextReaderilişkili tüm sistem kaynaklarını serbest bırakır.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	nesnesi tarafından TextReader kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	TextReader tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
Peek()	Okuyucunun veya karakter kaynağının durumunu değiştirmeden sonraki karakteri okur. Okuyucudan gerçekten okumadan bir sonraki kullanılabilir karakteri döndürür.
Read()	Metin okuyucudan sonraki karakteri okur ve karakter konumunu bir karakter ilerletir.
Read(Char[], Int32, Int32)	Geçerli okuyucudan belirtilen en fazla karakter sayısını okur ve belirtilen dizinden başlayarak verileri arabelleğe yazar.
Read(Span<Char>)	Geçerli okuyucudaki karakterleri okur ve verileri belirtilen arabelleğe yazar.
ReadAsync(Char[], Int32, Int32)	Geçerli metin okuyucudan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve verileri belirtilen dizinden başlayarak arabelleğe yazar.
ReadAsync(Memory<Char>, CancellationToken)	Geçerli akıştan gelen karakterleri zaman uyumsuz olarak bir bellek bloğuna okur.
ReadBlock(Char[], Int32, Int32)	Geçerli metin okuyucudan belirtilen en fazla karakter sayısını okur ve belirtilen dizinden başlayarak verileri arabelleğe yazar.
ReadBlock(Span<Char>)	Geçerli akıştan karakterleri okur ve verileri arabelleğe yazar.
ReadBlockAsync(Char[], Int32, Int32)	Geçerli metin okuyucudan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve verileri belirtilen dizinden başlayarak arabelleğe yazar.
ReadBlockAsync(Memory<Char>, CancellationToken)	Geçerli akıştan karakterleri zaman uyumsuz olarak okur ve verileri arabelleğe yazar.
ReadLine()	Metin okuyucudan bir karakter satırı okur ve verileri dize olarak döndürür.
ReadLineAsync()	Bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.
ReadLineAsync(CancellationToken)	Bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.
ReadToEnd()	Geçerli konumdan metin okuyucunun sonuna kadar olan tüm karakterleri okur ve bunları tek dize olarak döndürür.
ReadToEndAsync()	Geçerli konumdan metin okuyucunun sonuna kadar olan tüm karakterleri zaman uyumsuz olarak okur ve bunları tek bir dize olarak döndürür.
ReadToEndAsync(CancellationToken)	Geçerli konumdan metin okuyucunun sonuna kadar olan tüm karakterleri zaman uyumsuz olarak okur ve bunları tek bir dize olarak döndürür.
Synchronized(TextReader)	Belirtilen TextReaderetrafında iş parçacığı güvenli bir sarmalayıcı oluşturur.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• StringReader
• StreamReader
• Dosya ve Stream G/Ç
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Bir Dosyaya Metin Yazma
• Nasıl yapılır: Yeni Oluşturulan bir Veri Dosyasını Okuma ve Dosyaya Yazma