FileStream.Read Método

Definição

Namespace:

System.IO

Assemblies:

mscorlib.dll, System.IO.FileSystem.dll

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

System.IO.FileSystem.dll

Assembly:

mscorlib.dll

Sobrecargas

Read(Byte[], Int32, Int32)	Lê um bloco de bytes do fluxo e grava os dados em um buffer específico.
Read(Span<Byte>)	Lê uma sequência de bytes do fluxo de arquivo atual e avança a posição no fluxo de arquivo até o número de bytes lidos.

Read(Byte[], Int32, Int32)

Lê um bloco de bytes do fluxo e grava os dados em um buffer específico.

public:
 override int Read(cli::array <System::Byte> ^ array, int offset, int count);

public:
 override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);

public override int Read (byte[] array, int offset, int count);

public override int Read (byte[] buffer, int offset, int count);

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

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

Public Overrides Function Read (array As Byte(), offset As Integer, count As Integer) As Integer

Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

Parâmetros

arraybuffer

Byte[]

Quando este método retorna, ele contém a matriz de bytes especificada com os valores entre offset e (offset + count -1) substituídos pelos bytes lidos da fonte atual.

offset

Int32

O deslocamento de bytes no array no qual os bytes lidos serão colocados.

count

Int32

O número máximo de bytes a serem lidos.

Retornos

Int32

O número total de bytes lidos do buffer. Isso poderá ser menor que o número de bytes solicitado se esse número de bytes não estiver disponível no momento, ou zero, se o final do fluxo for atingido.

Exceções

ArgumentNullException

array é null.

ArgumentOutOfRangeException

offset ou count é negativo.

NotSupportedException

Não há suporte para leitura no fluxo.

IOException

Ocorreu um erro de E/S.

ArgumentException

offset e count descrevem um intervalo inválido em array.

ObjectDisposedException

Foram chamados métodos depois que o fluxo foi fechado.

Exemplos

O exemplo a seguir lê o conteúdo de um FileStream e grava-o em outro FileStream .

using System;
using System.IO;

class Test
{

public static void Main()
{
    // Specify a file to read from and to create.
    string pathSource = @"c:\tests\source.txt";
    string pathNew = @"c:\tests\newfile.txt";

    try
    {

        using (FileStream fsSource = new FileStream(pathSource,
            FileMode.Open, FileAccess.Read))
        {

            // Read the source file into a byte array.
            byte[] bytes = new byte[fsSource.Length];
            int numBytesToRead = (int)fsSource.Length;
            int numBytesRead = 0;
            while (numBytesToRead > 0)
            {
                // Read may return anything from 0 to numBytesToRead.
                int n = fsSource.Read(bytes, numBytesRead, numBytesToRead);

                // Break when the end of the file is reached.
                if (n == 0)
                    break;

                numBytesRead += n;
                numBytesToRead -= n;
            }
             numBytesToRead = bytes.Length;

            // Write the byte array to the other FileStream.
            using (FileStream fsNew = new FileStream(pathNew,
                FileMode.Create, FileAccess.Write))
            {
                fsNew.Write(bytes, 0, numBytesToRead);
            }
        }
    }
    catch (FileNotFoundException ioEx)
    {
        Console.WriteLine(ioEx.Message);
    }
}
}

Imports System.IO
Class Test
    
Public Shared Sub Main()
    ' Specify a file to read from and to create.
    Dim pathSource As String = "c:\tests\source.txt"
    Dim pathNew As String = "c:\tests\newfile.txt"
    Try 
        Using fsSource As FileStream = New FileStream(pathSource, _
            FileMode.Open, FileAccess.Read)
            ' Read the source file into a byte array.
                Dim bytes() As Byte = New Byte((fsSource.Length) - 1) {}
                Dim numBytesToRead As Integer = CType(fsSource.Length,Integer)
                Dim numBytesRead As Integer = 0

                While (numBytesToRead > 0)
                    ' Read may return anything from 0 to numBytesToRead.
                    Dim n As Integer = fsSource.Read(bytes, numBytesRead, _
                        numBytesToRead)
                    ' Break when the end of the file is reached.
                    If (n = 0) Then
                        Exit While
                    End If
                    numBytesRead = (numBytesRead + n)
                    numBytesToRead = (numBytesToRead - n)

                End While
            numBytesToRead = bytes.Length

            ' Write the byte array to the other FileStream.
            Using fsNew As FileStream = New FileStream(pathNew, _
                FileMode.Create, FileAccess.Write)
                fsNew.Write(bytes, 0, numBytesToRead)
            End Using
        End Using
    Catch ioEx As FileNotFoundException
        Console.WriteLine(ioEx.Message)
    End Try
End Sub
End Class

Comentários

Este método substitui Read.

O offset parâmetro fornece o deslocamento do byte em array (o índice de buffer) no qual começar a ler e o count parâmetro fornece o número máximo de bytes a serem lidos neste fluxo. O valor retornado é o número real de bytes lidos ou zero se o final do fluxo for atingido. Se a operação de leitura for bem-sucedida, a posição atual do fluxo será avançada pelo número de bytes lidos. Se ocorrer uma exceção, a posição atual do fluxo será inalterada.

O Read método retorna zero somente depois de atingir o final do fluxo. Caso contrário, o Read sempre lerá pelo menos um byte do fluxo antes de retornar. Se nenhum dado estiver disponível do fluxo em uma chamada para Read , o método será bloqueado até que pelo menos um byte de dados possa ser retornado. Uma implementação é livre para retornar menos bytes do que o solicitado, mesmo que o final do fluxo não tenha sido atingido.

Use BinaryReader para ler tipos de dados primitivos.

Não interrompa um thread que esteja executando uma operação de leitura. Embora o aplicativo possa parecer ser executado com êxito depois que o thread é desbloqueado, a interrupção pode diminuir o desempenho e a confiabilidade do seu aplicativo.

Para obter uma lista de operações de arquivo e diretório comuns, consulte tarefas comuns de e/s.

Confira também

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

Read(Span<Byte>)

Lê uma sequência de bytes do fluxo de arquivo atual e avança a posição no fluxo de arquivo até o número de bytes lidos.

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

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

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

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

Parâmetros

buffer

Span<Byte>

Uma região da memória. Quando esse método é retornado, o conteúdo dessa região é substituído pelos bytes lidos do fluxo de arquivo atual.

Retornos

Int32

O número total de bytes lidos do buffer. Isso poderá ser menor que o número de bytes alocados no buffer se esses muitos bytes não estiverem disponíveis no momento, ou zero (0), se o final do fluxo tiver sido atingido.

Comentários

Use a CanRead propriedade para determinar se a instância atual oferece suporte à leitura. Use o ReadAsync método para ler de forma assíncrona o fluxo atual.

Esse método lê um máximo de buffer.Length bytes do fluxo de arquivos atual e os armazena em buffer . A posição atual dentro do fluxo de arquivos é avançada pelo número de bytes lidos; no entanto, se ocorrer uma exceção, a posição atual dentro do fluxo de arquivos permanecerá inalterada. O método será bloqueado até que pelo menos um byte de dados possa ser lido, caso nenhum dado esteja disponível. Read Retorna 0 somente quando não há mais dados no fluxo de arquivos e não é mais esperado (como um soquete ou fim de arquivo fechado). O método é livre para retornar menos bytes do que o solicitado, mesmo que o final do fluxo de arquivos não tenha sido atingido.

Use BinaryReader para ler tipos de dados primitivos.