ISpanAuthenticatedEncryptor.Encrypt<TWriter> Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.