ISpanAuthenticatedEncryptor.Encrypt<TWriter> Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Шифрует и проверяет подлинность фрагмента данных с открытым текстом и записывает результат в буферный модуль записи.
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)
Параметры типа
- TWriter
Тип записи буфера для записи зашифрованного текста.
Параметры
- plaintext
- ReadOnlySpan<Byte>
Открытый текст для шифрования. Эти входные данные могут быть нулевыми байтами длиной.
- additionalAuthenticatedData
- ReadOnlySpan<Byte>
Часть данных, которые не будут включены в возвращаемый зашифрованный текст, но который по-прежнему будет охватываться тегом проверки подлинности. Эти входные данные могут быть нулевыми байтами длиной. Тот же AAD должен быть указан в соответствующем вызове Decrypt<TWriter>(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, TWriter).
- destination
- TWriter
Буферный модуль записи, в который будет записан зашифрованный текст (включая тег проверки подлинности).
Комментарии
Этот метод предоставляет оптимизированную, потоковую альтернативу Encrypt(ArraySegment<Byte>, ArraySegment<Byte>). Вместо выделения промежуточного буфера зашифрованный текст записывается непосредственно в предоставленный буферный модуль записи, что может повысить производительность и уменьшить давление на выделение памяти. Модуль записи буфера расширен общим количеством байтов, записанных в него.