ISpanAuthenticatedEncryptor.Encrypt<TWriter> Méthode

Définition

Chiffre et authentifie un élément de données en texte clair et écrit le résultat dans un enregistreur de mémoire tampon.

public void Encrypt<TWriter>(ReadOnlySpan<byte> plaintext, ReadOnlySpan<byte> additionalAuthenticatedData, ref TWriter destination) where TWriter : System.Buffers.IBufferWriter<byte>, allows ref struct;
abstract member Encrypt : ReadOnlySpan<byte> * ReadOnlySpan<byte> * 'Writer -> unit (requires 'Writer :> System.Buffers.IBufferWriter<byte>)
Public Sub Encrypt(Of TWriter As IBufferWriter(Of Byte)) (plaintext As ReadOnlySpan(Of Byte), additionalAuthenticatedData As ReadOnlySpan(Of Byte), ByRef destination As TWriter)

Paramètres de type

TWriter

Type d’enregistreur de mémoire tampon dans lequel écrire le texte chiffré.

Paramètres

plaintext
ReadOnlySpan<Byte>

Texte en clair à chiffrer. Cette entrée peut être égale à zéro octet de longueur.

additionalAuthenticatedData
ReadOnlySpan<Byte>

Élément de données qui ne sera pas inclus dans le texte chiffré retourné, mais qui sera toujours couvert par la balise d’authentification. Cette entrée peut être égale à zéro octet de longueur. Le même AAD doit être spécifié dans l’appel correspondant à Decrypt<TWriter>(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, TWriter).

destination
TWriter

Enregistreur de mémoire tampon dans lequel le texte chiffré (y compris la balise d’authentification) sera écrit.

Remarques

Cette méthode fournit une alternative optimisée en streaming à Encrypt(ArraySegment<Byte>, ArraySegment<Byte>). Au lieu d’allouer une mémoire tampon intermédiaire, le texte chiffré est écrit directement dans l’enregistreur de mémoire tampon fourni, ce qui peut améliorer les performances et réduire la pression d’allocation de mémoire. L’enregistreur de mémoire tampon est avancé par le nombre total d’octets écrits.

S’applique à