AesGcm.Decrypt Metoda

Definice

Obor názvů:

System.Security.Cryptography

Sestavení:

System.Security.Cryptography.dll

Přetížení

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Dešifruje šifrový text do zadané cílové vyrovnávací paměti, pokud je možné ověřit ověřovací značku.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Dešifruje šifrový text do zadané cílové vyrovnávací paměti, pokud je možné ověřit ověřovací značku.

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

Zdroj:

AesGcm.cs

Dešifruje šifrový text do zadané cílové vyrovnávací paměti, pokud je možné ověřit ověřovací značku.

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)

Parametry

nonce

Byte[]

Jiná hodnota přidružená k této zprávě, která se musí shodovat s hodnotou zadanou během šifrování.

ciphertext

Byte[]

Šifrovaný obsah k dešifrování.

tag

Byte[]

Ověřovací značka vytvořená pro tuto zprávu během šifrování.

plaintext

Byte[]

Bajtové pole pro příjem dešifrovaného obsahu.

associatedData

Byte[]

Další data přidružená k této zprávě, která musí odpovídat hodnotě zadané během šifrování.

Výjimky

ArgumentException

Parametr plaintext a ciphertext nemají stejnou délku.

-nebo-

Délka parametru nonce není povolena NonceByteSizes.

-nebo-

Délka parametru tag není povolena TagByteSizes.

ArgumentNullException

Parametr nonce, ciphertext, tagnebo plaintext je null.

CryptographicException

Operace dešifrování se nezdařila. Před .NET 8 označuje, že hodnotu značky nebylo možné ověřit.

AuthenticationTagMismatchException

.NET 8 a novější verze: Hodnotu značky nelze ověřit.

Poznámky

Pokud tag nelze ověřit (pomocí klíče, nonce, ciphertexta associatedData hodnot), plaintext se vymaže.

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

Zdroj:

AesGcm.cs

Dešifruje šifrový text do zadané cílové vyrovnávací paměti, pokud je možné ověřit ověřovací značku.

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)

Parametry

nonce

ReadOnlySpan<Byte>

Jiná hodnota přidružená k této zprávě, která se musí shodovat s hodnotou zadanou během šifrování.

ciphertext

ReadOnlySpan<Byte>

Šifrovaný obsah k dešifrování.

tag

ReadOnlySpan<Byte>

Ověřovací značka vytvořená pro tuto zprávu během šifrování.

plaintext

Span<Byte>

Rozsah bajtů pro příjem dešifrovaného obsahu.

associatedData

ReadOnlySpan<Byte>

Další data přidružená k této zprávě, která musí odpovídat hodnotě zadané během šifrování.

Výjimky

ArgumentException

Parametr plaintext a ciphertext nemají stejnou délku.

-nebo-

Délka parametru nonce není povolena NonceByteSizes.

-nebo-

Délka parametru tag není povolena TagByteSizes.

CryptographicException

Operace dešifrování se nezdařila. Před .NET 8 označuje, že hodnotu značky nebylo možné ověřit.

AuthenticationTagMismatchException

.NET 8 a novější verze: Hodnotu značky nelze ověřit.

Poznámky

Pokud tag nelze ověřit (pomocí klíče, nonce, ciphertexta associatedData hodnot), plaintext se vymaže.