AesGcm.Decrypt 方法

参考

定义

命名空间:: System.Security.Cryptography

程序集:: System.Security.Cryptography.Algorithms.dll

程序集:: System.Security.Cryptography.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	如果可以验证身份验证标记，将密码文本解密到提供的目标缓冲区。
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	如果可以验证身份验证标记，将密码文本解密到提供的目标缓冲区。

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

Source:: AesGcm.cs

Source:: AesGcm.cs

Source:: AesGcm.cs

如果可以验证身份验证标记，将密码文本解密到提供的目标缓冲区。

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

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 长度不相同。

-或-

NonceByteSizes不允许 nonce 参数长度。

-或-

TagByteSizes不允许 tag 参数长度。

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

Source:: AesGcm.cs

Source:: AesGcm.cs

Source:: AesGcm.cs