Base64.EncodeToUtf8 Método

Definição

Namespace:

System.Buffers.Text

Assembly:

System.Runtime.dll

Origem:

Base64Encoder.cs

Codifica a extensão de dados binários em texto codificado em UTF-8 representado como base 64.

public static System.Buffers.OperationStatus EncodeToUtf8 (ReadOnlySpan<byte> bytes, Span<byte> utf8, out int bytesConsumed, out int bytesWritten, bool isFinalBlock = true);

static member EncodeToUtf8 : ReadOnlySpan<byte> * Span<byte> * int * int * bool -> System.Buffers.OperationStatus

Public Shared Function EncodeToUtf8 (bytes As ReadOnlySpan(Of Byte), utf8 As Span(Of Byte), ByRef bytesConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus

Parâmetros

bytes

ReadOnlySpan<Byte>

A extensão de entrada que contém dados binários que precisam ser codificados.

utf8

Span<Byte>

A extensão de saída que contém o resultado da operação, ou seja, o texto codificado em UTF-8 na base 64.

bytesConsumed

Int32

Quando esse método retorna, contém o número de bytes de entrada consumidos durante a operação. Isso pode ser usado para fatiar a entrada para chamadas subsequentes, se necessário.

bytesWritten

Int32

Quando esse método retorna, contém o número de bytes gravados no intervalo de saída. Isso pode ser usado para fatiar a saída para chamadas subsequentes, se necessário.

isFinalBlock

Boolean

true (o padrão) para indicar que o intervalo de entrada contém os dados inteiros a serem codificados. false para indicar que o intervalo de entrada contém dados parciais com mais dados a seguir.

Retornos

OperationStatus

Um dos valores de enumeração que indica o status da operação de codificação.

Comentários

O valor retornado pode ser o seguinte:

• OperationStatus.Done: o processamento de todo o intervalo de entrada foi bem-sucedido.
• OperationStatus.DestinationTooSmall: não há espaço suficiente no intervalo de saída para se ajustar à entrada codificada.
• OperationStatus.NeedMoreData: isFinalBlock é false. Caso contrário, se isFinalBlock for true, a saída será preenchida se a entrada não for um múltiplo de 3.

Esse método não pode retornar OperationStatus.InvalidData , pois isso não é possível para codificação de base 64.