StringReader Osztály

Definíció

Névtér:
System.IO
Szerelvények:
mscorlib.dll, System.IO.dll
Szerelvények:
netstandard.dll, System.Runtime.dll
Szerelvény:
System.IO.dll
Szerelvény:
System.Runtime.Extensions.dll
Szerelvény:
mscorlib.dll
Szerelvény:
netstandard.dll
Forrás:
StringReader.cs
Forrás:
StringReader.cs
Forrás:
StringReader.cs
Forrás:
StringReader.cs
Forrás:
StringReader.cs

Egy sztringből TextReader beolvasott szöveget valósít meg.

public ref class StringReader : System::IO::TextReader
public class StringReader : System.IO.TextReader
[System.Serializable]
public class StringReader : System.IO.TextReader
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringReader : System.IO.TextReader
type StringReader = class
    inherit TextReader
[<System.Serializable>]
type StringReader = class
    inherit TextReader
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringReader = class
    inherit TextReader
Public Class StringReader
Inherits TextReader
Öröklődés
Object
TextReader
StringReader
Öröklődés
Object
MarshalByRefObject
TextReader
StringReader
Attribútumok
SerializableAttribute ComVisibleAttribute

Példák

Az alábbi példa egy teljes sztring aszinkron olvasását mutatja be.

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
'

Megjegyzések

StringReader lehetővé teszi a sztring szinkron vagy aszinkron olvasását. Egyszerre egy karaktert olvashat a metódussal vagy a Read metódussal, egy vonalat egyszerre a metódus vagy a ReadAsyncReadLine metódus használatával, és egy teljes sztringet a vagy a ReadLineAsyncReadToEnd metódus ReadToEndAsync használatával.

Note

Ez a típus implementálja az interfészt IDisposable , de valójában nincs elidegenítendő erőforrása. Ez azt jelenti, hogy a Dispose() közvetlen meghívásával vagy egy olyan nyelvi szerkezettel, mint például using (C#-ban) vagy Using (Visual Basic) nem szükséges.

Az alábbi táblázat más tipikus vagy kapcsolódó I/O-feladatokra mutat be példákat.

Ehhez... Tekintse meg a jelen témakörben szereplő példát...
Szövegfájl létrehozása. Útmutató: Szöveg írása fájlba
Írás szövegfájlba. Útmutató: Szöveg írása fájlba
Olvasás szövegfájlból. Útmutató: Szöveg beolvasása fájlból
Szöveg hozzáfűzése egy fájlhoz. Útmutató: Naplófájl megnyitása és hozzáfűzése

File.AppendText

FileInfo.AppendText
Fájl méretének lekérése. FileInfo.Length
A fájl attribútumainak lekérése. File.GetAttributes
Adja meg egy fájl attribútumait. File.SetAttributes
Állapítsa meg, hogy létezik-e fájl. File.Exists
Olvasás bináris fájlból. Útmutató: Olvasás és írás újonnan létrehozott adatfájlba
Írás bináris fájlba. Útmutató: Olvasás és írás újonnan létrehozott adatfájlba

Konstruktorok

Name Description
StringReader(String)

Inicializálja a StringReader megadott sztringből beolvasott osztály új példányát.

Metódusok

Name Description
Close()

Bezárja a StringReader.
CreateObjRef(Type)

Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt.

(Öröklődés forrása MarshalByRefObject)
Dispose()

Felszabadítja az objektum által használt összes erőforrást TextReader .

(Öröklődés forrása TextReader)
Dispose(Boolean)

Felszabadítja a felügyelt erőforrások által StringReader 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()

A következő elérhető karaktert adja vissza, de nem használja.
Read()

Beolvassa a következő karaktert a bemeneti sztringből, és egy karakterrel előrelépteti a karakter pozícióját.
Read(Char[], Int32, Int32)

Beolvassa a karakterblokkot a bemeneti sztringből, és előrelépteti a karakter pozícióját.count
Read(Span<Char>)

Beolvassa a bemeneti sztring összes karakterét az aktuális pozíciótól kezdve, és az aktuális pozíciót a bemeneti sztring végére alakítja.
ReadAsync(Char[], Int32, Int32)

Beolvassa a megadott maximális számú karaktert az aktuális sztringből aszinkron módon, és a megadott indextől kezdve egy pufferbe írja az adatokat.
ReadAsync(Memory<Char>, CancellationToken)

Aszinkron módon beolvassa a bemeneti sztring összes karakterét az aktuális pozíciótól kezdve, és az aktuális pozíciót a bemeneti sztring végére viszi.
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.

(Öröklődés forrása TextReader)
ReadBlock(Span<Char>)

Beolvassa a bemeneti sztring összes karakterét az aktuális pozíciótól kezdve, és az aktuális pozíciót a bemeneti sztring végére alakítja.
ReadBlockAsync(Char[], Int32, Int32)

Beolvassa a megadott maximális számú karaktert az aktuális sztringből aszinkron módon, és a megadott indextől kezdve egy pufferbe írja az adatokat.
ReadBlockAsync(Memory<Char>, CancellationToken)

Aszinkron módon beolvassa a bemeneti sztring összes karakterét az aktuális pozíciótól kezdve, és az aktuális pozíciót a bemeneti sztring végére viszi.
ReadLine()

Beolvas egy karaktersort az aktuális sztringből, és sztringként adja vissza az adatokat.
ReadLineAsync()

Egy karaktersort aszinkron módon olvas be az aktuális sztringből, és sztringként adja vissza az adatokat.
ReadLineAsync(CancellationToken)

Egy karaktersort aszinkron módon olvas be az aktuális sztringből, és sztringként adja vissza az adatokat.
ReadToEnd()

Beolvassa az összes karaktert az aktuális pozíciótól a sztring végéig, és egyetlen sztringként adja vissza őket.
ReadToEndAsync()

Beolvassa az összes karaktert az aktuális pozíciótól a sztring végéig aszinkron módon, és egyetlen sztringként adja vissza őket.
ReadToEndAsync(CancellationToken)

Beolvassa az összes karaktert az aktuális pozíciótól a sztring végéig aszinkron módon, és egyetlen sztringként adja vissza őket.
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

Explicit interfész-implementációk

Name Description
IDisposable.Dispose()

Ennek a tagnak a leírását lásd Dispose(): .

(Öröklődés forrása TextReader)

A következőre érvényes:

Lásd még