StringReader.Read Método

Definição

Namespace:: System.IO

Assemblies:: mscorlib.dll, System.IO.dll

Assembly:: mscorlib.dll

Assembly:: System.IO.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.

Lê o próximo caractere ou próximo conjunto de caracteres da cadeia de caracteres de entrada.

Sobrecargas

Nome	Description
Read()	Lê o próximo caractere da cadeia de caracteres de entrada e avança a posição do caractere por um caractere.
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.
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()

Lê o próximo caractere da cadeia de caracteres de entrada e avança a posição do caractere por um caractere.

public:
 override int Read();

public override int Read();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

Retornos

Int32

O próximo caractere da cadeia de caracteres subjacente ou -1 se não houver mais caracteres disponíveis.

Exceções

ObjectDisposedException

O leitor atual está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a StringReader classe.

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Comentários

Esse método substitui o TextReader.Read método.

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

Confira também

Aplica-se a

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.

public:
 override int Read(Span<char> buffer);

public override int Read(Span<char> buffer);

override this.Read : Span<char> -> int

Public Overrides Function Read (buffer As Span(Of Char)) As Integer

Parâmetros

buffer: Span<Char>

Quando esse método é retornado, contém os caracteres lidos da fonte atual. Se o número total de caracteres lidos for zero, o intervalo permanecerá não modificado.

Retornos

Int32

O número total de caracteres lidos no buffer.

Exceções

ObjectDisposedException

A instância atual do leitor de cadeia de caracteres está fechada.

Aplica-se a

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.

public:
 override int Read(cli::array <char> ^ buffer, int index, int count);

public override int Read(char[] buffer, int index, int count);

override this.Read : char[] * int * int -> int

Public Overrides Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Parâmetros

buffer: Char[]

Quando esse método é retornado, contém a matriz de caracteres especificada com os valores entre index e (index + count - 1) substituídos pelos caracteres lidos da fonte atual.

index: Int32

O índice inicial no buffer.

count: Int32

O número de caracteres a serem lidos.

Retornos

Int32

O número total de caracteres lidos no buffer. Isso pode ser menor do que o número de caracteres solicitados se muitos caracteres não estiverem disponíveis no momento ou zero se o final da cadeia de caracteres subjacente tiver sido atingido.

Exceções

ArgumentNullException

buffer é null.

ArgumentException

O tamanho do buffer menos index é menor que count.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

O leitor atual está fechado.

Comentários

Este método substitui TextReader.Read.

O método lerá até count caracteres StringReaderbuffer da matriz de caracteres começando na posição index. Retorna o número real de caracteres lidos ou zero se o final da cadeia de caracteres tiver sido atingido e nenhum caractere for lido.

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

Confira também

Aplica-se a

Comentários

Esta página foi útil?