HMACSHA1.HashDataAsync 方法

定義

命名空間:

System.Security.Cryptography

組件:

System.Security.Cryptography.dll

多載

HashDataAsync(Byte[], Stream, CancellationToken)	使用 SHA1 演算法以異步方式計算數據流的 HMAC。
HashDataAsync(ReadOnlyMemory<Byte>, Stream, CancellationToken)	使用 SHA1 演算法以異步方式計算數據流的 HMAC。
HashDataAsync(ReadOnlyMemory<Byte>, Stream, Memory<Byte>, CancellationToken)	使用 SHA1 演算法以異步方式計算數據流的 HMAC。

HashDataAsync(Byte[], Stream, CancellationToken)

來源:

HMACSHA1.cs

使用 SHA1 演算法以異步方式計算數據流的 HMAC。

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())

參數

key

Byte[]

HMAC 鍵。

source

Stream

HMAC 的數據流。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None。

傳回

ValueTask<Byte[]>

數據的 HMAC。

例外狀況

ArgumentNullException

key 或 source 為 null。

ArgumentException

source 不支援讀取。

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 所 HashData(Byte[], Stream)擲回的例外狀況。

HashDataAsync(ReadOnlyMemory<Byte>, Stream, CancellationToken)

來源:

HMACSHA1.cs

使用 SHA1 演算法以異步方式計算數據流的 HMAC。

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())

參數

key

ReadOnlyMemory<Byte>

HMAC 鍵。

source

Stream

HMAC 的數據流。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None。

傳回

ValueTask<Byte[]>

數據的 HMAC。

例外狀況

ArgumentNullException

source 為 null。

ArgumentException

source 不支援讀取。

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

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

來源:

HMACSHA1.cs

使用 SHA1 演算法以異步方式計算數據流的 HMAC。

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)

參數

key

ReadOnlyMemory<Byte>

HMAC 鍵。

source

Stream

HMAC 的數據流。

destination

Memory<Byte>

要接收 HMAC 值的緩衝區。

cancellationToken

CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None。

傳回

ValueTask<Int32>

寫入 destination 的總位元組數。

例外狀況

ArgumentNullException

source 為 null。

ArgumentException

destination 中的緩衝區太小而無法保存計算的雜湊大小。 SHA1 演算法一律會產生 160 位元雜湊，或 20 個位元組。

-或-

source 不支援讀取。

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。