StringReader Třída

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.IO.dll

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Zdroj:: StringReader.cs

Zdroj:: StringReader.cs

Zdroj:: StringReader.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object

TextReader
StringReader

Dědičnost: Object

MarshalByRefObject

TextReader
StringReader

Atributy: SerializableAttribute ComVisibleAttribute

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 Read ReadAsync , řá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

Sdílet prostřednictvím