StringReader Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

StringReader.cs

Dizeden TextReader okuyan bir uygular.

public ref class StringReader : System::IO::TextReader

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Devralma

Object

MarshalByRefObject

TextReader

StringReader

Örnekler

Aşağıdaki örnekte, bir dizenin tamamının zaman uyumsuz olarak nasıl okunduğu gösterilmektedir.

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            StringBuilder stringToRead = new StringBuilder();
            stringToRead.AppendLine("Characters in 1st line to read");
            stringToRead.AppendLine("and 2nd line");
            stringToRead.AppendLine("and the end");

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                string readText = await reader.ReadToEndAsync();
                Console.WriteLine(readText);
            }
        }
    }
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = New StringBuilder()
        stringToRead.AppendLine("Characters in 1st line to read")
        stringToRead.AppendLine("and 2nd line")
        stringToRead.AppendLine("and the end")

        Using reader As StringReader = New StringReader(stringToRead.ToString())
            Dim readText As String = Await reader.ReadToEndAsync()
            Console.WriteLine(readText)
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

Açıklamalar

StringReader bir dizeyi zaman uyumlu veya zaman uyumsuz olarak okumanızı sağlar. veya yöntemiyle Read bir kerede bir karakter, veya ReadAsync yöntemini kullanarak ReadLine bir kerede bir satır ve veya ReadLineAsync yöntemini kullanarak ReadToEnd dizenin ReadToEndAsync tamamını okuyabilirsiniz.

Not

Bu tür arabirimini IDisposable uygular, ancak aslında atılacak kaynağı yoktur. Başka bir deyişle, doğrudan çağırarak Dispose() veya (C#'da) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanarak yok saymak gerekli değildir.

Aşağıdaki tabloda, diğer tipik veya ilgili G/Ç görevlerinin örnekleri listelidir.

Bunu yapmak için...	Bu konudaki örneğe bakın...
Bir metin dosyası İçerik Oluşturucu.	Nasıl yapılır: Bir Dosyaya Metin Yazma
Metin dosyasına yazma.	Nasıl yapılır: Bir Dosyaya Metin Yazma
Metin dosyasından okuma.	Nasıl yapılır: Dosyadan Metin Okuma
Dosyaya metin ekleme.	Nasıl yapılır: Günlük Dosyasını Açma ve Sonuna Ekleme File.AppendText FileInfo.AppendText
Dosyanın boyutunu alın.	FileInfo.Length
Bir dosyanın özniteliklerini alın.	File.GetAttributes
Dosyanın özniteliklerini ayarlayın.	File.SetAttributes
Bir dosyanın var olup olmadığını belirleyin.	File.Exists
İkili dosyadan okuma.	Nasıl yapılır: Yeni Oluşturulan bir Veri Dosyasını Okuma ve Dosyaya Yazma
İkili bir dosyaya yazın.	Nasıl yapılır: Yeni Oluşturulan bir Veri Dosyasını Okuma ve Dosyaya Yazma

Oluşturucular

StringReader(String)

Belirtilen dizeden okuyan sınıfının yeni bir örneğini StringReader başlatır.

Yöntemler

Close()	öğesini StringReaderkapatı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. (Devralındığı yer: TextReader)
Dispose(Boolean)	StringReader 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()	Bir sonraki kullanılabilir karakteri döndürür ancak kullanmaz.
Read()	Giriş dizesinden sonraki karakteri okur ve karakter konumunu bir karakter ilerletir.
Read(Char[], Int32, Int32)	Giriş dizesinden bir karakter bloğu okur ve karakter konumunu ile countilerletir.
Read(Span<Char>)	Giriş dizesinden geçerli konumdan başlayarak tüm karakterleri okur ve geçerli konumu giriş dizesinin sonuna ilerletir.
ReadAsync(Char[], Int32, Int32)	Geçerli dizeden 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)	Giriş dizesinden geçerli konumdan başlayarak tüm karakterleri zaman uyumsuz olarak okur ve geçerli konumu giriş dizesinin sonuna ilerler.
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. (Devralındığı yer: TextReader)
ReadBlock(Span<Char>)	Geçerli konumdan başlayarak giriş dizesinden tüm karakterleri okur ve geçerli konumu giriş dizesinin sonuna ilerler.
ReadBlockAsync(Char[], Int32, Int32)	Geçerli dizeden 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 konumdan başlayarak giriş dizesinden tüm karakterleri zaman uyumsuz olarak okur ve geçerli konumu giriş dizesinin sonuna ilerler.
ReadLine()	Geçerli dizeden bir karakter satırı okur ve verileri dize olarak döndürür.
ReadLineAsync()	Geçerli dizeden bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.
ReadLineAsync(CancellationToken)	Geçerli dizeden bir karakter satırını zaman uyumsuz olarak okur ve verileri dize olarak döndürür.
ReadToEnd()	Geçerli konumdan dizenin sonuna kadar olan tüm karakterleri okur ve bunları tek bir dize olarak döndürür.
ReadToEndAsync()	Geçerli konumdan dizenin 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 dizenin sonuna kadar olan tüm karakterleri zaman uyumsuz olarak okur ve bunları tek bir dize olarak döndürür.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• TextReader
• StringWriter
• Dosya ve Stream G/Ç
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Bir Dosyaya Metin Yazma