FileStream.Read FileStream.Read FileStream.Read FileStream.Read Method

Definição

Sobrecargas

Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32)

Lê um bloco de bytes do fluxo e grava os dados em um buffer específico.Reads a block of bytes from the stream and writes the data in a given buffer.

Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>) 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.Reads a sequence of bytes from the current file stream and advances the position within the file stream by the number of bytes read.

Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32) Read(Byte[], Int32, Int32)

Lê um bloco de bytes do fluxo e grava os dados em um buffer específico.Reads a block of bytes from the stream and writes the data in a given buffer.

public:
 override int Read(cli::array <System::Byte> ^ array, int offset, int count);
public override int Read (byte[] array, int offset, int count);
override this.Read : byte[] * int * int -> int
Public Overrides Function Read (array As Byte(), offset As Integer, count As Integer) As Integer

Parâmetros

array
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.When this method returns, contains the specified byte array with the values between offset and (offset + count - 1) replaced by the bytes read from the current source.

offset
Int32 Int32 Int32 Int32

O deslocamento de bytes no array no qual os bytes lidos serão colocados.The byte offset in array at which the read bytes will be placed.

count
Int32 Int32 Int32 Int32

O número máximo de bytes a serem lidos.The maximum number of bytes to read.

Retornos

O número total de bytes lidos do buffer.The total number of bytes read into the 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.This might be less than the number of bytes requested if that number of bytes are not currently available, or zero if the end of the stream is reached.

Exceções

Não há suporte para leitura no fluxo.The stream does not support reading.

Ocorreu um erro de E/S.An I/O error occurred.

offset e count descrevem um intervalo inválido em array.offset and count describe an invalid range in array.

Foram chamados métodos depois que o fluxo foi fechado.Methods were called after the stream was closed.

Exemplos

O exemplo a seguir lê o conteúdo de FileStream um e grava-o FileStreamem outro.The following example reads the contents from a FileStream and writes it into another 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
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.This method overrides 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.The offset parameter gives the offset of the byte in array (the buffer index) at which to begin reading, and the count parameter gives the maximum number of bytes to be read from this stream. O valor retornado é o número real de bytes lidos ou zero se o final do fluxo for atingido.The returned value is the actual number of bytes read, or zero if the end of the stream is reached. Se a operação de leitura for bem-sucedida, a posição atual do fluxo será avançada pelo número de bytes lidos.If the read operation is successful, the current position of the stream is advanced by the number of bytes read. Se ocorrer uma exceção, a posição atual do fluxo será inalterada.If an exception occurs, the current position of the stream is unchanged.

O Read método retorna zero somente depois de atingir o final do fluxo.The Read method returns zero only after reaching the end of the stream. Caso contrário Read , o sempre lerá pelo menos um byte do fluxo antes de retornar.Otherwise, Read always reads at least one byte from the stream before returning. 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.If no data is available from the stream upon a call to Read, the method will block until at least one byte of data can be returned. Uma implementação é livre para retornar menos bytes do que o solicitado, mesmo que o final do fluxo não tenha sido atingido.An implementation is free to return fewer bytes than requested even if the end of the stream has not been reached.

Use BinaryReader para ler tipos de dados primitivos.Use BinaryReader for reading primitive data types.

Não interrompa um thread que esteja executando uma operação de leitura.Do not interrupt a thread that is performing a read operation. 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.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Para obter uma lista de operações de arquivo e diretório comuns, consulte tarefas comuns de e/s.For a list of common file and directory operations, see Common I/O Tasks.

Veja também

Read(Span<Byte>) Read(Span<Byte>) Read(Span<Byte>) 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.Reads a sequence of bytes from the current file stream and advances the position within the file stream by the number of bytes read.

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.A region of memory. Quando esse método é retornado, o conteúdo dessa região é substituído pelos bytes lidos do fluxo de arquivo atual.When this method returns, the contents of this region are replaced by the bytes read from the current file stream.

Retornos

O número total de bytes lidos do buffer.The total number of bytes read into the 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.This can be less than the number of bytes allocated in the buffer if that many bytes are not currently available, or zero (0) if the end of the stream has been reached.

Comentários

Use a CanRead propriedade para determinar se a instância atual oferece suporte à leitura.Use the CanRead property to determine whether the current instance supports reading. Use o ReadAsync método para ler de forma assíncrona o fluxo atual.Use the ReadAsync method to read asynchronously from the current stream.

Esse método lê um máximo de buffer.Length bytes do fluxo de arquivos atual e os armazena em buffer.This method reads a maximum of buffer.Length bytes from the current file stream and stores them in 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.The current position within the file stream is advanced by the number of bytes read; however, if an exception occurs, the current position within the file stream remains unchanged. O método será bloqueado até que pelo menos um byte de dados possa ser lido, caso nenhum dado esteja disponível.The method will block until at least one byte of data can be read, in the event that no data is available. ReadRetorna 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).Read returns 0 only when there is no more data in the file stream and no more is expected (such as a closed socket or end of file). 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.The method is free to return fewer bytes than requested even if the end of the file stream has not been reached.

Use BinaryReader para ler tipos de dados primitivos.Use BinaryReader for reading primitive data types.

Aplica-se a