ChaCha20Poly1305.Encrypt 方法

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.dll

重载

Encrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	将纯文本加密到已加密文本目标缓冲区，并将身份验证标签生成到单独的缓冲区中。
Encrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	将纯文本加密到已加密文本目标缓冲区，并将身份验证标签生成到单独的缓冲区中。

Encrypt(Byte[], Byte[], Byte[], Byte[], Byte[])

Source:

ChaCha20Poly1305.cs

将纯文本加密到已加密文本目标缓冲区，并将身份验证标签生成到单独的缓冲区中。

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

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

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

参数

nonce

Byte[]

与此消息相关联的 nonce。对于具有相同密钥的每个操作，它应该是唯一值。

plaintext

Byte[]

要加密的内容。

ciphertext

Byte[]

接收加密内容的字节数组。

tag

Byte[]

接收生成的身份验证标记的字节数组。

associatedData

Byte[]

与此消息关联的额外数据。该数据还必须在解密过程中提供。

例外

ArgumentException

plaintext 参数和 ciphertext 的长度不同。

- 或 -

参数 nonce 长度不是 12 字节 (96 位) 。

-或-

参数 tag 长度不是 16 字节 (128 位) 。

ArgumentNullException

nonce、ciphertext、tag 或 plaintext 参数为 null。

CryptographicException

加密操作失败。

注解

ChaCha20/Poly1305 算法模式的安全保证要求，同一个 nonce 值永远不会用于同一键两次。

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

Source:

ChaCha20Poly1305.cs

将纯文本加密到已加密文本目标缓冲区，并将身份验证标签生成到单独的缓冲区中。

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

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

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

参数

nonce

ReadOnlySpan<Byte>

与此消息相关联的 nonce。对于具有相同密钥的每个操作，它应该是唯一值。

plaintext

ReadOnlySpan<Byte>

要加密的内容。

ciphertext

Span<Byte>

接收加密内容的字节数组。

tag

Span<Byte>

接收生成的身份验证标记的字节数组。

associatedData

ReadOnlySpan<Byte>

与此消息关联的额外数据。该数据还必须在解密过程中提供。

例外

ArgumentException

plaintext 参数和 ciphertext 的长度不同。

- 或 -

参数 nonce 长度不是 12 字节 (96 位) 。

-或-

参数 tag 长度不是 16 字节 (128 位) 。

ArgumentNullException

nonce、ciphertext、tag 或 plaintext 参数为 null。

CryptographicException

加密操作失败。

注解

ChaCha20/Poly1305 算法模式的安全保证要求，同一个 nonce 值永远不会用于同一键两次。