StringReader Classe

Definição

Implementa um TextReader que lê 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
StringReader
Herança
Atributos

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 ReadToEnd método ou o ReadToEndAsync método.

Note

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

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

Para fazer isto... 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
Leitura 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

Nome Description
StringReader(String)

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

Métodos

Nome Description
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 TextReader objeto.

(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 hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(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 por um caractere.

Read(Char[], Int32, Int32)

Lê um bloco de caracteres da cadeia de caracteres de entrada e avança a posição do caractere por 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 até o final da cadeia de caracteres de entrada.

ReadAsync(Char[], Int32, Int32)

Lê um número máximo especificado de caracteres da cadeia de caracteres atual de forma assíncrona e grava os dados em um buffer, começando no índice especificado.

ReadAsync(Memory<Char>, CancellationToken)

Lê de forma assíncrona 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 número 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 começando na posição atual e avança a posição atual para o final da cadeia de caracteres de entrada.

ReadBlockAsync(Char[], Int32, Int32)

Lê um número máximo especificado de caracteres da cadeia de caracteres atual de forma assíncrona e grava os dados em um buffer, começando no índice especificado.

ReadBlockAsync(Memory<Char>, CancellationToken)

Lê de forma assíncrona 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.

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 de forma assíncrona 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.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
IDisposable.Dispose()

Para obter uma descrição deste membro, consulte Dispose().

(Herdado de TextReader)

Aplica-se a

Confira também