TextReader Sınıf

Tanım

Ardışık bir karakter serisini okuyabilen bir okuyucuyu temsil eder.Represents a reader that can read a sequential series of characters.

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
TextReader
Devralma
Türetilmiş
Öznitelikler
Uygulamalar

Örnekler

TextReaderSınıf, soyut bir sınıftır.The TextReader class is an abstract class. Bu nedenle, bu kodu kodunuzda örnekleyemezsiniz.Therefore, you do not instantiate it in your code. StreamReaderSınıfı öğesinden türetilir TextReader ve bir akıştan okumak için üyelerin uygulamalarını sağlar.The StreamReader class derives from TextReader and provides implementations of the members for reading from a stream. Aşağıdaki örnek, yöntemi kullanılarak bir dosyadaki tüm karakterlerin nasıl okunacağını gösterir StreamReader.ReadAsync(Char[], Int32, Int32) .The following example shows how to read all the characters in a file by using the StreamReader.ReadAsync(Char[], Int32, Int32) method. Karakteri sınıfının bir örneğine eklemeden önce, her karakterin bir harf, rakam veya boşluk olduğunu denetler StringBuilder .It checks whether each character is a letter, digit, or white space before adding the character to an instance of the StringBuilder class.

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 , ve ' nin Özet taban sınıfıdır StreamReader ve StringReader sırasıyla akışlardan ve Dizelerdeki karakterleri okur.TextReader is the abstract base class of StreamReader and StringReader, which read characters from streams and strings, respectively. Bu türetilmiş sınıfları, belirli bir karakter aralığını okumak için veya var olan bir akışa dayalı bir okuyucu oluşturmak için kullanın.Use these derived classes to open a text file for reading a specified range of characters, or to create a reader based on an existing stream.

Önemli

Bu tür, IDisposable arabirimini uygular.This type implements the IDisposable interface. Bu türden türetilen herhangi bir türü kullanmayı bitirdiğinizde, bunu doğrudan veya dolaylı olarak atabilirsiniz.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Türü doğrudan atmak için, Dispose yöntemini bir try / catch blokta çağırın.To dispose of the type directly, call its Dispose method in a try/catch block. Dolaylı olarak atmak için using (C# dilinde) veya (Visual Basic) gibi bir dil yapısı kullanın Using .To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Daha fazla bilgi için, bkz. The Dispose ve "IDisposable uygulayan bir nesne kullanma" bölümü IDisposable .For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Uygulayanlara Notlar

Türetilmiş bir sınıf, Peek() Read() yararlı bir örneğini oluşturmak için ve yöntemlerini en az düzeyde uygulamalıdır TextReader .A derived class must minimally implement the Peek() and Read() methods to make a useful instance of TextReader.

Oluşturucular

TextReader()

TextReader sınıfının yeni bir örneğini başlatır.Initializes a new instance of the TextReader class.

Alanlar

Null

TextReaderOkunacak veri olmadan bir sağlar.Provides a TextReader with no data to read from.

Yöntemler

Close()

TextReader' İ kapatır ve ile ilişkili tüm sistem kaynaklarını serbest bırakır TextReader .Closes the TextReader and releases any system resources associated with the TextReader.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm bilgileri içeren bir nesne oluşturur.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Devralındığı yer: MarshalByRefObject)
Dispose()

Nesne tarafından kullanılan tüm kaynakları serbest bırakır TextReader .Releases all resources used by the TextReader object.

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.Releases the unmanaged resources used by the TextReader and optionally releases the managed resources.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetLifetimeService()
Kullanımdan kalktı.

Bu örnek için ömür ilkesini denetleyen geçerli ömür hizmeti nesnesini alır.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
InitializeLifetimeService()
Kullanımdan kalktı.

Bu örnek için ömür ilkesini denetlemek üzere bir ömür hizmeti nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli nesnenin basit bir kopyasını oluşturur MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Devralındığı yer: MarshalByRefObject)
Peek()

Okuyucu durumunu veya karakter kaynağını değiştirmeden sonraki karakteri okur.Reads the next character without changing the state of the reader or the character source. Gerçekten okuyucudan okumadan, kullanılabilir bir sonraki karakteri döndürür.Returns the next available character without actually reading it from the reader.

Read()

Metin okuyucudan sonraki karakteri okur ve karakter konumunu bir karakter ile ilerletir.Reads the next character from the text reader and advances the character position by one character.

Read(Char[], Int32, Int32)

Geçerli okuyucudan belirtilen en fazla sayıda karakteri okur ve belirtilen dizinden başlayarak verileri bir arabelleğe yazar.Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.

Read(Span<Char>)

Geçerli okuyucudaki karakterleri okur ve verileri belirtilen arabelleğe yazar.Reads the characters from the current reader and writes the data to the specified buffer.

ReadAsync(Char[], Int32, Int32)

Geçerli metin okuyucusundan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve belirtilen dizinden başlayarak verileri bir arabelleğe yazar.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.

ReadAsync(Memory<Char>, CancellationToken)

Geçerli akıştan gelen karakterleri zaman uyumsuz olarak bir bellek bloğuna okur.Asynchronously reads the characters from the current stream into a memory block.

ReadBlock(Char[], Int32, Int32)

Geçerli metin okuyucudan belirtilen en fazla sayıda karakteri okur ve belirtilen dizinden başlayarak verileri bir arabelleğe yazar.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

ReadBlock(Span<Char>)

Geçerli akıştan karakterleri okur ve verileri bir arabelleğe yazar.Reads the characters from the current stream and writes the data to a buffer.

ReadBlockAsync(Char[], Int32, Int32)

Geçerli metin okuyucusundan belirtilen en fazla karakter sayısını zaman uyumsuz olarak okur ve belirtilen dizinden başlayarak verileri bir arabelleğe yazar.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.

ReadBlockAsync(Memory<Char>, CancellationToken)

Geçerli akıştaki karakterleri zaman uyumsuz olarak okur ve verileri bir arabelleğe yazar.Asynchronously reads the characters from the current stream and writes the data to a buffer.

ReadLine()

Metin okuyucudaki bir karakter satırını okur ve verileri bir dize olarak döndürür.Reads a line of characters from the text reader and returns the data as a string.

ReadLineAsync()

Bir karakter satırını zaman uyumsuz olarak okur ve verileri bir dize olarak döndürür.Reads a line of characters asynchronously and returns the data as a string.

ReadToEnd()

Geçerli konumdan metin okuyucunun sonuna kadar olan tüm karakterleri okur ve bunları tek bir dize olarak döndürür.Reads all characters from the current position to the end of the text reader and returns them as one string.

ReadToEndAsync()

Geçerli konumdan metin okuyucunun sonuna zaman uyumsuz olarak tüm karakterleri okur ve bunları tek bir dize olarak döndürür.Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.

Synchronized(TextReader)

Belirtilen etrafında bir iş parçacığı güvenli sarmalayıcı oluşturur TextReader .Creates a thread-safe wrapper around the specified TextReader.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu üyenin açıklaması için bkz Dispose() ..For a description of this member, see Dispose().

Şunlara uygulanır

Ayrıca bkz.