StringReader Classe

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

StringReader.cs

Implementa um TextReader lido de uma cadeia de caracteres.

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

public class StringReader : System.IO.TextReader

type StringReader = class
    inherit TextReader

Public Class StringReader
Inherits TextReader

Herança

Object

MarshalByRefObject

TextReader

StringReader

Exemplos

O exemplo a seguir mostra como ler uma cadeia de caracteres inteira de forma assíncrona.

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
'

Comentários

StringReader permite que você leia uma cadeia de caracteres de forma síncrona ou assíncrona. Você pode ler um caractere de cada vez com o Read método ou ReadAsync , uma linha de cada vez usando o ReadLine método ou ReadLineAsync e uma cadeia de caracteres inteira usando o ReadToEnd método ou ReadToEndAsync .

Observação

Esse tipo implementa a interface IDisposable, mas, na verdade, não tem todos os recursos para descarte. Isso significa que não é necessário descartá-lo chamando diretamente Dispose() ou usando um constructo de linguagem como using (em C#) ou Using (em Visual Basic).

A tabela a seguir lista exemplos de outras tarefas de E/S típicas ou relacionadas.

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como gravar texto em um arquivo
Gravar em um arquivo de texto.	Como gravar texto em um arquivo
Ler de um arquivo de texto.	Como ler texto de um arquivo
Acrescente o texto a um arquivo.	Como abrir e acrescentar a um arquivo de log File.AppendText FileInfo.AppendText
Obtenha o tamanho de um arquivo.	FileInfo.Length
Obtenha os atributos de um arquivo.	File.GetAttributes
Defina os atributos de um arquivo.	File.SetAttributes
Determine se existe um arquivo.	File.Exists
Ler de um arquivo binário.	Como ler e gravar em um arquivo de dados recém-criado
Gravar em um arquivo binário.	Como ler e gravar em um arquivo de dados recém-criado

Construtores

StringReader(String)

Inicializa uma nova instância da classe StringReader que lê da cadeia de caracteres especificada.

Métodos

Close()	Fecha o StringReader.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo objeto TextReader. (Herdado de TextReader)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo StringReader e opcionalmente libera os recursos gerenciados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
Peek()	Retorna o próximo caractere disponível, mas não o consome.
Read()	Lê o próximo caractere da cadeia de caracteres de entrada e avança a posição do caractere em um caractere.
Read(Char[], Int32, Int32)	Lê um bloco de caracteres da cadeia de caracteres da entrada e avança a posição do caractere em count.
Read(Span<Char>)	Lê todos os caracteres da cadeia de caracteres de entrada, começando na posição atual e avança a posição atual para o final da cadeia de caracteres de entrada.
ReadAsync(Char[], Int32, Int32)	Lê um número máximo especificado de caracteres do fluxo atual de forma assíncrona e grava os dados em um buffer, começando no índice especificado.
ReadAsync(Memory<Char>, CancellationToken)	Lê todos os caracteres da cadeia de caracteres de entrada, começando na posição atual, e avança a posição atual para o final da cadeia de caracteres de entrada.
ReadBlock(Char[], Int32, Int32)	Lê um máximo especificado de caracteres do leitor de texto atual e grava os dados em um buffer, começando no índice especificado. (Herdado de TextReader)
ReadBlock(Span<Char>)	Lê todos os caracteres da cadeia de caracteres de entrada, iniciando na posição atual, e avança a posição atual até o final da cadeia de caracteres de entrada.
ReadBlockAsync(Char[], Int32, Int32)	Lê um número máximo especificado de caracteres do fluxo atual de forma assíncrona e grava os dados em um buffer, começando no índice especificado.
ReadBlockAsync(Memory<Char>, CancellationToken)	Lê todos os caracteres de maneira assíncrona da cadeia de caracteres de entrada, começando na posição atual, e avança a posição atual para o final da cadeia de caracteres de entrada.
ReadLine()	Lê uma linha de caracteres da cadeia de caracteres atual e retorna os dados como uma cadeia de caracteres.
ReadLineAsync()	Lê uma linha de caracteres assincronamente da cadeia de caracteres atual e retorna os dados como uma cadeia de caracteres.
ReadLineAsync(CancellationToken)	Lê uma linha de caracteres assincronamente da cadeia de caracteres atual e retorna os dados como uma cadeia de caracteres.
ReadToEnd()	Lê todos os caracteres da posição atual até o final da cadeia de caracteres e os retorna como uma única cadeia de caracteres.
ReadToEndAsync()	Lê todos os caracteres da posição atual até o final da cadeia de caracteres de forma assíncrona e os retorna como uma única cadeia de caracteres.
ReadToEndAsync(CancellationToken)	Lê todos os caracteres da posição atual até o final da cadeia de caracteres de forma assíncrona e os retorna como uma única cadeia de caracteres.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• TextReader
• StringWriter
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo