StringReader Třída

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

StringReader.cs

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

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

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Dědičnost

Object

MarshalByRefObject

TextReader

StringReader

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
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.
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(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.
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.
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(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.
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(CancellationToken)	Přečte asynchronně řádek znaků z aktuálního řetězce a vrátí data jako řetězec.
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(CancellationToken)	Přečte všechny znaky od aktuální pozice do konce řetězce asynchronně a vrátí je jako jeden řetězec.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• TextReader
• StringWriter
• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru