ChaCha20Poly1305.Decrypt 方法

定義

命名空間:

System.Security.Cryptography

組件:

System.Security.Cryptography.dll

多載

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	如果可以驗證驗證標籤，將加密文字解密至提供的目的地緩衝區。
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	如果可以驗證驗證標籤，將加密文字解密至提供的目的地緩衝區。

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])

來源:

ChaCha20Poly1305.cs

如果可以驗證驗證標籤，將加密文字解密至提供的目的地緩衝區。

public void Decrypt (byte[] nonce, byte[] ciphertext, byte[] tag, byte[] plaintext, byte[]? associatedData = default);

member this.Decrypt : byte[] * byte[] * byte[] * byte[] * byte[] -> unit

Public Sub Decrypt (nonce As Byte(), ciphertext As Byte(), tag As Byte(), plaintext As Byte(), Optional associatedData As Byte() = Nothing)

參數

nonce

Byte[]

與此訊息相關聯的 Nonce，這必須符合加密期間提供的值。

ciphertext

Byte[]

要解密的加密內容。

tag

Byte[]

加密期間針對此訊息所產生的驗證標記。

plaintext

Byte[]

要接收解密內容的位元組陣列。

associatedData

Byte[]

與此訊息相關聯的額外數據，必須符合加密期間提供的值。

例外狀況

ArgumentException

plaintext 參數和 ciphertext 長度不相同。

-或-

nonce 參數長度不是 12 個字節（96 位）。

-或-

tag 參數長度不是 16 個字節（128 位）。

ArgumentNullException

nonce、 ciphertext、 tag或 plaintext 參數是 null。

CryptographicException

解密作業失敗。 在 .NET 8 之前，表示無法驗證標記值。

AuthenticationTagMismatchException

.NET 8 和更新版本：無法驗證標記值。

備註

如果無法驗證 tag （使用索引鍵、nonce、ciphertext和 associatedData 值），則會清除 plaintext。

Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)

來源:

ChaCha20Poly1305.cs

如果可以驗證驗證標籤，將加密文字解密至提供的目的地緩衝區。

public void Decrypt (ReadOnlySpan<byte> nonce, ReadOnlySpan<byte> ciphertext, ReadOnlySpan<byte> tag, Span<byte> plaintext, ReadOnlySpan<byte> associatedData = default);

member this.Decrypt : ReadOnlySpan<byte> * ReadOnlySpan<byte> * ReadOnlySpan<byte> * Span<byte> * ReadOnlySpan<byte> -> unit

Public Sub Decrypt (nonce As ReadOnlySpan(Of Byte), ciphertext As ReadOnlySpan(Of Byte), tag As ReadOnlySpan(Of Byte), plaintext As Span(Of Byte), Optional associatedData As ReadOnlySpan(Of Byte) = Nothing)

參數

nonce

ReadOnlySpan<Byte>

與此訊息相關聯的 Nonce，這必須符合加密期間提供的值。

ciphertext

ReadOnlySpan<Byte>

要解密的加密內容。

tag

ReadOnlySpan<Byte>

加密期間針對此訊息所產生的驗證標記。

plaintext

Span<Byte>

要接收解密內容的位元組陣列。

associatedData

ReadOnlySpan<Byte>

與此訊息相關聯的額外數據，必須符合加密期間提供的值。

例外狀況

ArgumentException

plaintext 參數和 ciphertext 長度不相同。

-或-

nonce 參數長度不是 12 個字節（96 位）。

-或-

tag 參數長度不是 16 個字節（128 位）。

CryptographicException

解密作業失敗。 在 .NET 8 之前，表示無法驗證標記值。

AuthenticationTagMismatchException

.NET 8 和更新版本：無法驗證標記值。

備註

如果無法驗證 tag （使用索引鍵、nonce、ciphertext和 associatedData 值），則會清除 plaintext。