StringReader.Read Método

Definição

Espaço de Nomes:: System.IO

Assemblagens:: mscorlib.dll, System.IO.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.IO.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Lê o próximo carácter ou o próximo conjunto de caracteres da cadeia de entrada.

Sobrecargas

Name	Description
Read()	Lê o próximo carácter da cadeia de entrada e avança a posição do carácter em um caractere.
Read(Span<Char>)	Lê todos os caracteres da cadeia de entrada, começando na posição atual, e avança a posição atual até ao fim da cadeia de entrada.
Read(Char[], Int32, Int32)	Lê um bloco de caracteres da cadeia de entrada e avança a posição do carácter por `count`.

Read()

Lê o próximo carácter da cadeia de entrada e avança a posição do carácter em um caractere.

public:
 override int Read();

public override int Read();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

Devoluções

Int32

O próximo carácter da cadeia subjacente, ou -1 se não houver mais caracteres disponíveis.

Exceções

ObjectDisposedException

O leitor atual está encerrado.

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

Observações

Este método sobrepõe-se ao TextReader.Read método.

A tabela seguinte lista exemplos de outras tarefas típicas ou relacionadas de E/S.

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como: Gravar texto em um arquivo
Escreve num ficheiro de texto.	Como: Gravar texto em um arquivo
Lido de um ficheiro de texto.	Como: Ler texto de um arquivo
Adicione texto a um ficheiro.	Como: Abrir e anexar a um arquivo de log File.AppendText FileInfo.AppendText
Obtém o tamanho de um ficheiro.	FileInfo.Length
Obtenha as características de um ficheiro.	File.GetAttributes
Defina os atributos de um ficheiro.	File.SetAttributes
Determina se existe um ficheiro.	File.Exists
Lê a partir de um ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado
Escreve num ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Ver também

Aplica-se a

Read(Span<Char>)

Lê todos os caracteres da cadeia de entrada, começando na posição atual, e avança a posição atual até ao fim da cadeia 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 regressa, contém os caracteres lidos da fonte atual. Se o número total de caracteres lidos for zero, o intervalo permanece inalterado.

Devoluções

Int32

O número total de caracteres lidos no buffer.

Exceções

ObjectDisposedException

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

Aplica-se a

Read(Char[], Int32, Int32)

Lê um bloco de caracteres da cadeia de entrada e avança a posição do carácter 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 este método regressa, contém o array de caracteres especificado 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 para ler.

Devoluções

Int32

O número total de caracteres lidos no buffer. Isto pode ser inferior ao número de caracteres solicitados se esse número de caracteres não estiver disponível atualmente, ou zero se o fim da cadeia subjacente for atingido.

Exceções

ArgumentNullException

buffer é null.

ArgumentException

O comprimento do buffer menos index é menor que count.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

O leitor atual está encerrado.

Observações

Este método substitui o TextReader.Read.

O método lê até count caracteres de o StringReader para o buffer array de caracteres começando na posição index. Devolve o número real de caracteres lidos, ou zero se o fim da cadeia for atingido e não forem lidos caracteres.

A tabela seguinte lista exemplos de outras tarefas típicas ou relacionadas de E/S.

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como: Gravar texto em um arquivo
Escreve num ficheiro de texto.	Como: Gravar texto em um arquivo
Lido de um ficheiro de texto.	Como: Ler texto de um arquivo
Adicione texto a um ficheiro.	Como: Abrir e anexar a um arquivo de log File.AppendText FileInfo.AppendText
Obtém o tamanho de um ficheiro.	FileInfo.Length
Obtenha as características de um ficheiro.	File.GetAttributes
Defina os atributos de um ficheiro.	File.SetAttributes
Determina se existe um ficheiro.	File.Exists
Lê a partir de um ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado
Escreve num ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Ver também

Aplica-se a

Comentários

Esta página foi útil?