Stream.ReadAtLeast(Span<Byte>, Int32, Boolean) Método
Definição
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ê pelo menos um número mínimo de bytes do fluxo atual e avança a posição dentro do fluxo pelo número de bytes lidos.
public int ReadAtLeast(Span<byte> buffer, int minimumBytes, bool throwOnEndOfStream = true);member this.ReadAtLeast : Span<byte> * int * bool -> intPublic Function ReadAtLeast (buffer As Span(Of Byte), minimumBytes As Integer, Optional throwOnEndOfStream As Boolean = true) As IntegerParâmetros
Uma região da memória. Quando este método retorna, o conteúdo desta região é substituído pelos bytes lidos do fluxo atual.
- minimumBytes
- Int32
O número mínimo de bytes para ler no buffer.
- throwOnEndOfStream
- Boolean
true lançar uma exceção se o fim do fluxo for alcançado antes da leitura minimumBytes dos bytes; false devolver menos do que minimumBytes quando o fim do fluxo é atingido.
A predefinição é true.
Devoluções
O número total de bytes lidos no buffer. Isto é garantido como maior ou igual a minimumBytes quando throwOnEndOfStream é true. Isto será menor do que minimumBytes quando se atinge o fim do fluxo e throwOnEndOfStream é false. Isto pode ser inferior ao número de bytes alocados no buffer se esse número de bytes não estiver disponível atualmente.
Exceções
minimumBytes é negativo, ou é maior que o comprimento de buffer.
throwOnEndOfStream é true e o fim do fluxo é alcançado antes de ler minimumBytes bytes de dados.
Observações
Quando minimumBytes é 0 (zero), esta operação de leitura será concluída sem esperar pelos dados disponíveis no fluxo.
