CryptoStream.Read(Byte[], Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Lê uma sequência de bytes do fluxo atual e avança a posição no fluxo até o número de bytes lidos.
public:
override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);
public override int Read (byte[] buffer, int offset, int count);
override this.Read : byte[] * int * int -> int
Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer
Parâmetros
- buffer
- Byte[]
Uma matriz de bytes. Um máximo de count
bytes são lidos do fluxo atual e armazenados em buffer
.
- offset
- Int32
O deslocamento de bytes em buffer
no qual será iniciada a leitura de dados no fluxo atual.
- count
- Int32
O número máximo de bytes a serem lidos no fluxo atual.
Retornos
O número total de bytes lidos do buffer. Isso poderá ser menor que o número de bytes solicitado se tal quantidade de bytes não estiver disponível no momento ou zero se o final do fluxo tiver sido atingido.
Exceções
O CryptoStreamMode associado ao objeto CryptoStream atual não corresponde ao fluxo subjacente. Por exemplo, essa exceção é gerada ao usar Read com um fluxo subjacente que é somente gravação.
offset
ou count
é menor que zero.
A soma dos parâmetros count
e offset
é maior do que o tamanho do buffer.
Comentários
A partir do .NET 6, esse método pode não ler tantos bytes quanto solicitado. Para obter mais informações, consulte Leituras parciais e de bytes zero em DeflateStream, GZipStream e CryptoStream.