StringReader Classe
Definição
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 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
- 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 |
| 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) |