TextReader Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.IO.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
System.Runtime.Extensions.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Sıralı karakter dizilerini okuyabilen bir okuyucunun temsilidir.

public ref class TextReader abstract : IDisposable
public ref class TextReader abstract : MarshalByRefObject, IDisposable
public abstract class TextReader : IDisposable
public abstract class TextReader : MarshalByRefObject, IDisposable
[System.Serializable]
public abstract class TextReader : MarshalByRefObject, IDisposable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextReader : MarshalByRefObject, IDisposable
type TextReader = class
    interface IDisposable
type TextReader = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
type TextReader = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextReader = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextReader
Implements IDisposable
Public MustInherit Class TextReader
Inherits MarshalByRefObject
Implements IDisposable
Devralma
Object
TextReader
Devralma
Object
MarshalByRefObject
TextReader
Türetilmiş
Öznitelikler
SerializableAttribute ComVisibleAttribute
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, akışlardan ve dizelerden sırasıyla karakterleri okuyan ve StringReadersoyut 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 blokta çağırın.Dispose Bunu dolaylı olarak atmak için (C#'ta) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanın. Daha fazla bilgi için dispose ve arabirim konusunda "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 düzeyde 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 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 verileri belirtilen dizinden başlayarak bir 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 bir arabelleğe yazar.
ReadAsync(Memory<Char>, CancellationToken)

Geçerli akıştan 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 verileri belirtilen dizinden başlayarak 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 bir 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 bir 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 TextReaderçevresinde 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)

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu üyenin açıklaması için bkz Dispose(). .

Şunlara uygulanır

Ayrıca bkz.