StringReader Classe

Referência

Definição

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Implementa um TextReader lido de uma cadeia de caracteres.

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

Herança: Object

TextReader
StringReader

Herança: Object

MarshalByRefObject

TextReader
StringReader

Atributos: SerializableAttribute ComVisibleAttribute

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 o ReadAsync método, uma linha de cada vez usando o ReadLine método ou o ReadLineAsync método e uma cadeia de caracteres inteira usando o método ou o ReadToEnd ReadToEndAsync método.

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 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.
Close()	Fecha o TextReader e libera os recursos do sistema associados ao `TextReader`. (Herdado de TextReader)
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.
Read(Span<Char>)	Lê os caracteres do leitor atual e grava os dados no buffer especificado. (Herdado de TextReader)
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(Char[], Int32, Int32)	Lê um número máximo especificado de caracteres do leitor de texto atual de forma assíncrona e grava os dados em um buffer, começando no índice especificado. (Herdado de TextReader)
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.
ReadAsync(Memory<Char>, CancellationToken)	Lê de forma assíncrona os caracteres do fluxo atual para um bloco de memória. (Herdado de TextReader)
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.
ReadBlock(Span<Char>)	Lê os caracteres do fluxo atual e grava os dados em um buffer. (Herdado de TextReader)
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(Char[], Int32, Int32)	Lê um número máximo especificado de caracteres do leitor de texto atual de forma assíncrona e grava os dados em um buffer, começando no índice especificado. (Herdado de TextReader)
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.
ReadBlockAsync(Memory<Char>, CancellationToken)	Lê de forma assíncrona os caracteres do fluxo atual e grava os dados em um buffer. (Herdado de TextReader)
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()	Lê uma linha de caracteres assincronamente e retorna os dados como uma cadeia de caracteres. (Herdado de TextReader)
ReadLineAsync(CancellationToken)	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 e retorna os dados como uma cadeia de caracteres. (Herdado de TextReader)
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()	Lê todos os caracteres da posição atual até o final do leitor de texto de forma assíncrona e os retorna como uma cadeia de caracteres. (Herdado de TextReader)
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.
ReadToEndAsync(CancellationToken)	Lê todos os caracteres da posição atual até o final do leitor de texto de forma assíncrona e os retorna como uma cadeia de caracteres. (Herdado de TextReader)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

IDisposable.Dispose()

Para obter uma descrição desse membro, confira Dispose().

(Herdado de TextReader)

Aplica-se a