Freigeben über

AesGcm.Decrypt Methode

  • Referenz

Definition

Namespace:
System.Security.Cryptography
Assembly:
System.Security.Cryptography.Algorithms.dll
Assembly:
System.Security.Cryptography.dll
Assembly:
netstandard.dll

Überlädt

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

Entschlüsselt den Verschlüsselungstext in den bereitgestellten Zielpuffer, wenn das Authentifizierungstag überprüft werden kann.
Decrypt(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>)

Entschlüsselt den Verschlüsselungstext in den bereitgestellten Zielpuffer, wenn das Authentifizierungstag überprüft werden kann.

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

Quelle:
AesGcm.cs
Quelle:
AesGcm.cs
Quelle:
AesGcm.cs

Entschlüsselt den Verschlüsselungstext in den bereitgestellten Zielpuffer, wenn das Authentifizierungstag überprüft werden kann.

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)

Parameter

nonce
Byte[]

Die dieser Nachricht zugeordnete Nonce, die dem während der Verschlüsselung bereitgestellten Wert entsprechen muss.

ciphertext
Byte[]

Der zu entschlüsselnde verschlüsselte Inhalt.

tag
Byte[]

Das für diese Nachricht während der Verschlüsselung erstellte Authentifizierungstag.

plaintext
Byte[]

Das Bytearray, das den entschlüsselten Inhalt empfängt.

associatedData
Byte[]

Zusätzliche Daten, die dieser Nachricht zugeordnet sind, die dem während der Verschlüsselung bereitgestellten Wert entsprechen müssen.

Ausnahmen

ArgumentException

Der plaintext-Parameter und die ciphertext haben nicht dieselbe Länge.

-oder-

Die Länge des nonce Parameters ist von NonceByteSizesnicht zulässig.

-oder-

Die Länge des tag Parameters ist von TagByteSizesnicht zulässig.

ArgumentNullException

Der Parameter nonce, ciphertext, tagoder plaintext ist null.

CryptographicException

Fehler beim Entschlüsselungsvorgang. Gibt vor .NET 8 an, dass der Tagwert nicht überprüft werden konnte.

AuthenticationTagMismatchException

.NET 8 und höhere Versionen: Der Tagwert konnte nicht überprüft werden.

Hinweise

Wenn tag nicht überprüft werden kann (mit dem Schlüssel, nonce, ciphertextund associatedData Werten), wird plaintext gelöscht.

Gilt für:

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

Quelle:
AesGcm.cs
Quelle:
AesGcm.cs
Quelle:
AesGcm.cs

Entschlüsselt den Verschlüsselungstext in den bereitgestellten Zielpuffer, wenn das Authentifizierungstag überprüft werden kann.

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>

Die dieser Nachricht zugeordnete Nonce, die dem während der Verschlüsselung bereitgestellten Wert entsprechen muss.

ciphertext
ReadOnlySpan<Byte>

Der zu entschlüsselnde verschlüsselte Inhalt.

tag
ReadOnlySpan<Byte>

Das für diese Nachricht während der Verschlüsselung erstellte Authentifizierungstag.

plaintext
Span<Byte>

Der Bytebereich, um den entschlüsselten Inhalt zu empfangen.

associatedData
ReadOnlySpan<Byte>

Zusätzliche Daten, die dieser Nachricht zugeordnet sind, die dem während der Verschlüsselung bereitgestellten Wert entsprechen müssen.

Ausnahmen

ArgumentException

Der plaintext-Parameter und die ciphertext haben nicht dieselbe Länge.

-oder-

Die Länge des nonce Parameters ist von NonceByteSizesnicht zulässig.

-oder-

Die Länge des tag Parameters ist von TagByteSizesnicht zulässig.

CryptographicException

Fehler beim Entschlüsselungsvorgang. Gibt vor .NET 8 an, dass der Tagwert nicht überprüft werden konnte.

AuthenticationTagMismatchException

.NET 8 und höhere Versionen: Der Tagwert konnte nicht überprüft werden.

Hinweise

Wenn tag nicht überprüft werden kann (mit dem Schlüssel, nonce, ciphertextund associatedData Werten), wird plaintext gelöscht.

Gilt für: