HMACSHA256.HashDataAsync Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Sobrecargas

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

HashDataAsync(Byte[], Stream, CancellationToken)

Origem:

HMACSHA256.cs

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

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

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

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

Parâmetros

key

Byte[]

A chave HMAC.

source

Stream

O fluxo para HMAC.

cancellationToken

CancellationToken

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

Retornos

ValueTask<Byte[]>

O HMAC dos dados.

Exceções

ArgumentNullException

key ou 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(Byte[], Stream).

HashDataAsync(ReadOnlyMemory<Byte>, Stream, CancellationToken)

Origem:

HMACSHA256.cs

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

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

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

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

Parâmetros

key

ReadOnlyMemory<Byte>

A chave HMAC.

source

Stream

O fluxo para HMAC.

cancellationToken

CancellationToken

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

Retornos

ValueTask<Byte[]>

O HMAC 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.

HashDataAsync(ReadOnlyMemory<Byte>, Stream, Memory<Byte>, CancellationToken)

Origem:

HMACSHA256.cs

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

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

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

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

Parâmetros

key

ReadOnlyMemory<Byte>

A chave HMAC.

source

Stream

O fluxo para HMAC.

destination

Memory<Byte>

O buffer que receberá o valor de HMAC.

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.