Sdílet prostřednictvím


StringReader Třída

Definice

Implementuje TextReader řetězec, který čte z řetězce.

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
Dědičnost
StringReader
Dědičnost
Atributy

Příklady

Následující příklad ukazuje, jak asynchronně číst celý řetězec.

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
'

Poznámky

StringReader umožňuje číst řetězec synchronně nebo asynchronně. Pomocí metody nebo můžete číst znaky v daném okamžiku ReadReadAsync , řádek po čase pomocí ReadLine metody nebo ReadLineAsync a celý řetězec pomocí ReadToEnd metody nebo ReadToEndAsync .

Poznámka

Tento typ implementuje IDisposable rozhraní, ale ve skutečnosti nemá žádné prostředky k odstranění. To znamená, že jeho odstranění přímým voláním Dispose() nebo pomocí konstruktoru jazyka, jako using je (v jazyce C#) nebo Using (v jazyce Visual Basic), není nutné.

Následující tabulka uvádí příklady dalších typických nebo souvisejících vstupně-výstupních úloh.

Požadovaná akce... Další informace naleznete v příkladu v tomto tématu...
Create textový soubor. Postupy: Zápis textu do souboru
Zápis do textového souboru Postupy: Zápis textu do souboru
Čtení z textového souboru. Postupy: Čtení textu ze souboru
Připojení textu k souboru Postupy: Otevření a připojení k souboru protokolu

File.AppendText

FileInfo.AppendText
Získejte velikost souboru. FileInfo.Length
Získejte atributy souboru. File.GetAttributes
Nastavte atributy souboru. File.SetAttributes
Zjistěte, jestli soubor existuje. File.Exists
Čtení z binárního souboru Postupy: Čtení a zápis do nově vytvořeného datového souboru
Zápis do binárního souboru Postupy: Čtení a zápis do nově vytvořeného datového souboru

Konstruktory

StringReader(String)

Inicializuje novou instanci StringReader třídy, která čte ze zadaného řetězce.

Metody

Close()

Zavře .StringReader

Close()

TextReader Zavře a uvolní všechny systémové prostředky přidružené k TextReader.

(Zděděno od TextReader)
CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()

Uvolní všechny prostředky používané objektem TextReader .

(Zděděno od TextReader)
Dispose(Boolean)

Uvolní nespravované prostředky používané StringReader nástrojem a volitelně uvolní spravované prostředky.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
Peek()

Vrátí další dostupný znak, ale nespotřebuje ho.

Read()

Přečte další znak ze vstupního řetězce a posune pozici znaku o jeden znak.

Read(Char[], Int32, Int32)

Přečte blok znaků ze vstupního řetězce a posune pozici znaku o count.

Read(Span<Char>)

Přečte všechny znaky ze vstupního řetězce počínaje aktuální pozicí a posune aktuální pozici na konec vstupního řetězce.

Read(Span<Char>)

Přečte znaky od aktuálního čtenáře a zapíše data do zadané vyrovnávací paměti.

(Zděděno od TextReader)
ReadAsync(Char[], Int32, Int32)

Přečte zadaný maximální počet znaků z aktuálního řetězce asynchronně a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

ReadAsync(Char[], Int32, Int32)

Přečte asynchronně zadaný maximální počet znaků z aktuální čtečky textu a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

(Zděděno od TextReader)
ReadAsync(Memory<Char>, CancellationToken)

Asynchronně přečte všechny znaky ze vstupního řetězce počínaje aktuální pozicí a posune aktuální pozici na konec vstupního řetězce.

ReadAsync(Memory<Char>, CancellationToken)

Asynchronně přečte znaky z aktuálního datového proudu do bloku paměti.

(Zděděno od TextReader)
ReadBlock(Char[], Int32, Int32)

Přečte zadaný maximální počet znaků z aktuální čtečky textu a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

(Zděděno od TextReader)
ReadBlock(Span<Char>)

Přečte všechny znaky ze vstupního řetězce počínaje aktuální pozicí a posune aktuální pozici na konec vstupního řetězce.

ReadBlock(Span<Char>)

Přečte znaky z aktuálního datového proudu a zapíše data do vyrovnávací paměti.

(Zděděno od TextReader)
ReadBlockAsync(Char[], Int32, Int32)

Přečte zadaný maximální počet znaků z aktuálního řetězce asynchronně a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

ReadBlockAsync(Char[], Int32, Int32)

Přečte asynchronně zadaný maximální počet znaků z aktuální čtečky textu a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

(Zděděno od TextReader)
ReadBlockAsync(Memory<Char>, CancellationToken)

Asynchronně přečte všechny znaky ze vstupního řetězce počínaje aktuální pozicí a posune aktuální pozici na konec vstupního řetězce.

ReadBlockAsync(Memory<Char>, CancellationToken)

Asynchronně přečte znaky z aktuálního datového proudu a zapíše data do vyrovnávací paměti.

(Zděděno od TextReader)
ReadLine()

Přečte řádek znaků z aktuálního řetězce a vrátí data jako řetězec.

ReadLineAsync()

Přečte asynchronně řádek znaků z aktuálního řetězce a vrátí data jako řetězec.

ReadLineAsync()

Přečte řádek znaků asynchronně a vrátí data jako řetězec.

(Zděděno od TextReader)
ReadLineAsync(CancellationToken)

Přečte asynchronně řádek znaků z aktuálního řetězce a vrátí data jako řetězec.

ReadLineAsync(CancellationToken)

Přečte řádek znaků asynchronně a vrátí data jako řetězec.

(Zděděno od TextReader)
ReadToEnd()

Přečte všechny znaky od aktuální pozice do konce řetězce a vrátí je jako jeden řetězec.

ReadToEndAsync()

Přečte všechny znaky od aktuální pozice do konce řetězce asynchronně a vrátí je jako jeden řetězec.

ReadToEndAsync()

Přečte asynchronně všechny znaky od aktuální pozice do konce čtečky textu a vrátí je jako jeden řetězec.

(Zděděno od TextReader)
ReadToEndAsync(CancellationToken)

Přečte všechny znaky od aktuální pozice do konce řetězce asynchronně a vrátí je jako jeden řetězec.

ReadToEndAsync(CancellationToken)

Přečte asynchronně všechny znaky od aktuální pozice do konce čtečky textu a vrátí je jako jeden řetězec.

(Zděděno od TextReader)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

IDisposable.Dispose()

Popis tohoto člena najdete v tématu Dispose().

(Zděděno od TextReader)

Platí pro

Viz také