StringReader.Read Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.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()

Origem:

StringReader.cs

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
Obter o tamanho de um arquivo.	FileInfo.Length
Obter 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

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

Read(Span<Char>)

Origem:

StringReader.cs

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.

Read(Char[], Int32, Int32)

Origem:

StringReader.cs

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é caracteres StringReader do na buffer matriz de caracteres começando na posição index.count 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
Obter o tamanho de um arquivo.	FileInfo.Length
Obter 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

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo