AesGcm.Encrypt Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Sobrecargas

Encrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Criptografa o texto não criptografado no buffer de destino do texto cifrado e gera a marca de autenticação em um buffer separado.
Encrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Criptografa o texto não criptografado no buffer de destino do texto cifrado e gera a marca de autenticação em um buffer separado.

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

Origem:

AesGcm.cs

Criptografa o texto não criptografado no buffer de destino do texto cifrado e gera a marca de autenticação em um buffer separado.

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)

Parâmetros

nonce

Byte[]

O nonce associado a essa mensagem, que deve ser um valor exclusivo para cada operação com a mesma chave.

plaintext

Byte[]

O conteúdo a ser criptografado.

ciphertext

Byte[]

A matriz de bytes a receber o conteúdo criptografado.

tag

Byte[]

A matriz de bytes a receber a marca de autenticação gerada.

associatedData

Byte[]

Dados extra associados a essa mensagem, que também devem ser fornecidos durante a descriptografia.

Exceções

ArgumentException

O parâmetro plaintext e o ciphertext não têm o mesmo comprimento.

- ou -

O comprimento do parâmetro nonce não é permitido por NonceByteSizes.

- ou -

O comprimento do parâmetro tag não é permitido por TagByteSizes.

ArgumentNullException

O parâmetro nonce, ciphertext, tag ou plaintext é null.

CryptographicException

Falha na operação de criptografia.

Comentários

As garantias de segurança do modo de algoritmo AES-GCM exigem que o mesmo valor de nonce nunca seja usado duas vezes com a mesma chave.

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

Origem:

AesGcm.cs

Criptografa o texto não criptografado no buffer de destino do texto cifrado e gera a marca de autenticação em um buffer separado.

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)

Parâmetros

nonce

ReadOnlySpan<Byte>

O nonce associado a essa mensagem, que deve ser um valor exclusivo para cada operação com a mesma chave.

plaintext

ReadOnlySpan<Byte>

O conteúdo a ser criptografado.

ciphertext

Span<Byte>

A matriz de bytes a receber o conteúdo criptografado.

tag

Span<Byte>

A matriz de bytes a receber a marca de autenticação gerada.

associatedData

ReadOnlySpan<Byte>

Dados extra associados a essa mensagem, que também devem ser fornecidos durante a descriptografia.

Exceções

ArgumentException

O parâmetro plaintext e o ciphertext não têm o mesmo comprimento.

- ou -

O comprimento do parâmetro nonce não é permitido por NonceByteSizes.

- ou -

O comprimento do parâmetro tag não é permitido por TagByteSizes.

CryptographicException

Falha na operação de criptografia.

Comentários

As garantias de segurança do modo de algoritmo AES-GCM exigem que o mesmo valor de nonce nunca seja usado duas vezes com a mesma chave.