StringReader.Read Método

  • 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

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

Sobrecargas

Read()

Lê o próximo caractere da cadeia de caracteres de entrada e avança a posição do caractere em 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 para o final da cadeia de caracteres de entrada.
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()

Lê o próximo caractere da cadeia de caracteres de entrada e avança a posição do caractere em 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 nenhum outro caractere estiver disponível.

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 = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

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 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

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 para 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 este método é retornado, contém os caracteres lidos da origem atual. Se o número total de caracteres lidos for zero, o intervalo continuará não modificado.

Retornos

Int32

O número total de caracteres lidos no buffer.

Exceções

ObjectDisposedException

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

Aplica-se a

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.

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 origem 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. Ele poderá ser menor que o número de caracteres solicitado se esse número de caracteres não estiver disponível no momento, ou zero se a cadeia de caracteres subjacente for atingida.

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 da matriz de StringReader buffer 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 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

Confira também

Aplica-se a