SHA256.HashDataAsync Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Sobrecargas

HashDataAsync(Stream, CancellationToken)	Calcula de forma assíncrona o hash de um fluxo usando o algoritmo SHA256.
HashDataAsync(Stream, Memory<Byte>, CancellationToken)	Calcula de forma assíncrona o hash de um fluxo usando o algoritmo SHA256.

HashDataAsync(Stream, CancellationToken)

Origem:

SHA256.cs

Calcula de forma assíncrona o hash de um fluxo usando o algoritmo SHA256.

public static System.Threading.Tasks.ValueTask<byte[]> HashDataAsync (System.IO.Stream source, System.Threading.CancellationToken cancellationToken = default);

static member HashDataAsync : System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<byte[]>

Public Shared Function HashDataAsync (source As Stream, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Byte())

Parâmetros

source

Stream

O fluxo para hash.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

ValueTask<Byte[]>

O hash dos dados.

Exceções

ArgumentNullException

source é null.

ArgumentException

source não dá suporte à leitura.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por HashData(Stream).

HashDataAsync(Stream, Memory<Byte>, CancellationToken)

Origem:

SHA256.cs

Calcula de forma assíncrona o hash de um fluxo usando o algoritmo SHA256.

public static System.Threading.Tasks.ValueTask<int> HashDataAsync (System.IO.Stream source, Memory<byte> destination, System.Threading.CancellationToken cancellationToken = default);

static member HashDataAsync : System.IO.Stream * Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Shared Function HashDataAsync (source As Stream, destination As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parâmetros

source

Stream

O fluxo para hash.

destination

Memory<Byte>

O buffer que recebe o valor de hash.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

ValueTask<Int32>

O número total de bytes gravados em destination.

Exceções

ArgumentNullException

source é null.

ArgumentException

O buffer no destination é muito pequeno para manter o tamanho do hash calculado. O algoritmo SHA256 sempre produz um hash de 256 bits ou 32 bytes.

-ou-

source não dá suporte à leitura.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.