StringReader Classe

Definição

Implementa um TextReader lido de uma cadeia de caracteres.Implements a TextReader that reads from a string.

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.The following example shows how to read an entire string asynchronously.

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.StringReader enables you to read a string synchronously or asynchronously. Você pode ler um caractere por vez com o Read ReadAsync método ou, uma linha por vez usando o ReadLine ou o ReadLineAsync método e uma cadeia de caracteres inteira usando o ReadToEnd método ou ReadToEndAsync .You can read a character at a time with the Read or the ReadAsync method, a line at a time using the ReadLine or the ReadLineAsync method and an entire string using the ReadToEnd or the ReadToEndAsync method.

Observação

Esse tipo implementa a interface IDisposable, mas, na verdade, não tem todos os recursos para descarte.This type implements the IDisposable interface, but does not actually have any resources to dispose. 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).This means that disposing it by directly calling Dispose() or by using a language construct such as using (in C#) or Using (in Visual Basic) is not necessary.

A tabela a seguir lista exemplos de outras tarefas de e/s típicas ou relacionadas.The following table lists examples of other typical or related I/O tasks.

Para fazer isso...To do this... Veja o exemplo neste tópico...See the example in this topic...
Crie um arquivo de texto.Create a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Gravar em um arquivo de texto.Write to a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Ler de um arquivo de texto.Read from a text file. Como ler texto de um arquivoHow to: Read Text from a File
Acrescentar texto a um arquivo.Append text to a file. Como abrir e acrescentar a um arquivo de logHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Obter o tamanho de um arquivo.Get the size of a file. FileInfo.Length
Obter os atributos de um arquivo.Get the attributes of a file. File.GetAttributes
Defina os atributos de um arquivo.Set the attributes of a file. File.SetAttributes
Determine se um arquivo existe.Determine if a file exists. File.Exists
Ler de um arquivo binário.Read from a binary file. Como ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File
Gravar em um arquivo binário.Write to a binary file. Como: Ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File

Construtores

StringReader(String)

Inicializa uma nova instância da classe StringReader que lê da cadeia de caracteres especificada.Initializes a new instance of the StringReader class that reads from the specified string.

Métodos

Close()

Fecha o StringReader.Closes the StringReader.

Close()

Fecha o TextReader e libera os recursos do sistema associados ao TextReader.Closes the TextReader and releases any system resources associated with the 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pelo objeto TextReader.Releases all resources used by the TextReader object.

(Herdado de TextReader)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo StringReader e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the StringReader and optionally releases the managed resources.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
Peek()

Retorna o próximo caractere disponível, mas não o consome.Returns the next available character but does not consume it.

Read()

Lê o próximo caractere da cadeia de caracteres de entrada e avança a posição do caractere em um caractere.Reads the next character from the input string and advances the character position by one character.

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.Reads a block of characters from the input string and advances the character position by 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.Reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

Read(Span<Char>)

Lê os caracteres do leitor atual e grava os dados no buffer especificado.Reads the characters from the current reader and writes the data to the specified buffer.

(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.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(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.Asynchronously reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string.

ReadAsync(Memory<Char>, CancellationToken)

Lê de forma assíncrona os caracteres do fluxo atual para um bloco de memória.Asynchronously reads the characters from the current stream into a memory block.

(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.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

(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.Reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlock(Span<Char>)

Lê os caracteres do fluxo atual e grava os dados em um buffer.Reads the characters from the current stream and writes the data to a 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.Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.

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.Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.

(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.Asynchronously reads all the characters from the input string starting at the current position and advances the current position to the end of the input string.

ReadBlockAsync(Memory<Char>, CancellationToken)

Lê de forma assíncrona os caracteres do fluxo atual e grava os dados em um buffer.Asynchronously reads the characters from the current stream and writes the data to a buffer.

(Herdado de TextReader)
ReadLine()

Lê uma linha de caracteres da cadeia de caracteres atual e retorna os dados como uma cadeia de caracteres.Reads a line of characters from the current string and returns the data as a string.

ReadLineAsync()

Lê uma linha de caracteres assincronamente da cadeia de caracteres atual e retorna os dados como uma cadeia de caracteres.Reads a line of characters asynchronously from the current string and returns the data as a string.

ReadLineAsync()

Lê uma linha de caracteres assincronamente e retorna os dados como uma cadeia de caracteres.Reads a line of characters asynchronously and returns the data as a string.

(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.Reads all characters from the current position to the end of the string and returns them as a single string.

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.Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.

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.Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.

(Herdado de TextReader)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

IDisposable.Dispose()

Para obter uma descrição desse membro, confira Dispose().For a description of this member, see Dispose().

(Herdado de TextReader)

Aplica-se a

Confira também