AesGcm.Decrypt Metode

Definisi

Ruang nama:

System.Security.Cryptography

Rakitan:

System.Security.Cryptography.dll

Overload

Decrypt(Byte[], Byte[], Byte[], Byte[], Byte[])	Mendekripsi ciphertext ke dalam buffer tujuan yang disediakan jika tag autentikasi dapat divalidasi.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)	Mendekripsi ciphertext ke dalam buffer tujuan yang disediakan jika tag autentikasi dapat divalidasi.

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

Sumber:

AesGcm.cs

Mendekripsi ciphertext ke dalam buffer tujuan yang disediakan jika tag autentikasi dapat divalidasi.

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)

Parameter

nonce

Byte[]

Nonce yang terkait dengan pesan ini, yang harus cocok dengan nilai yang disediakan selama enkripsi.

ciphertext

Byte[]

Konten terenkripsi untuk didekripsi.

tag

Byte[]

Tag autentikasi yang dihasilkan untuk pesan ini selama enkripsi.

plaintext

Byte[]

Array byte untuk menerima konten yang didekripsi.

associatedData

Byte[]

Data tambahan yang terkait dengan pesan ini, yang harus cocok dengan nilai yang disediakan selama enkripsi.

Pengecualian

ArgumentException

Parameter plaintext dan ciphertext tidak memiliki panjang yang sama.

-atau-

Panjang parameter nonce tidak diizinkan oleh NonceByteSizes.

-atau-

Panjang parameter tag tidak diizinkan oleh TagByteSizes.

ArgumentNullException

Parameter nonce, ciphertext, tag, atau plaintextnull.

CryptographicException

Operasi dekripsi gagal. Sebelum .NET 8, menunjukkan nilai tag tidak dapat diverifikasi.

AuthenticationTagMismatchException

.NET 8 dan versi yang lebih baru: nilai tag tidak dapat diverifikasi.

Keterangan

Jika tag tidak dapat divalidasi (menggunakan nilai kunci, nonce, ciphertext, dan associatedData), maka plaintext dihapus.

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

Sumber:

AesGcm.cs

Mendekripsi ciphertext ke dalam buffer tujuan yang disediakan jika tag autentikasi dapat divalidasi.

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)

Parameter

nonce

ReadOnlySpan<Byte>

Nonce yang terkait dengan pesan ini, yang harus cocok dengan nilai yang disediakan selama enkripsi.

ciphertext

ReadOnlySpan<Byte>

Konten terenkripsi untuk didekripsi.

tag

ReadOnlySpan<Byte>

Tag autentikasi yang dihasilkan untuk pesan ini selama enkripsi.

plaintext

Span<Byte>

Rentang byte untuk menerima konten yang didekripsi.

associatedData

ReadOnlySpan<Byte>

Data tambahan yang terkait dengan pesan ini, yang harus cocok dengan nilai yang disediakan selama enkripsi.

Pengecualian

ArgumentException

Parameter plaintext dan ciphertext tidak memiliki panjang yang sama.

-atau-

Panjang parameter nonce tidak diizinkan oleh NonceByteSizes.

-atau-

Panjang parameter tag tidak diizinkan oleh TagByteSizes.

CryptographicException

Operasi dekripsi gagal. Sebelum .NET 8, menunjukkan nilai tag tidak dapat diverifikasi.

AuthenticationTagMismatchException

.NET 8 dan versi yang lebih baru: nilai tag tidak dapat diverifikasi.

Keterangan

Jika tag tidak dapat divalidasi (menggunakan nilai kunci, nonce, ciphertext, dan associatedData), maka plaintext dihapus.