Base64.EncodeToUtf8 Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Codifica el intervalo de datos binarios en texto codificado 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>
El intervalo de entrada que contiene los datos binarios que se deben codificar.
El intervalo de salida que contiene el resultado de la operación, es decir, el texto codificado UTF-8 en base 64.
- bytesConsumed
- Int32
Cuando este método vuelve, contiene el número de bytes de entrada consumidos durante la operación. Esto puede usarse para segmentar la entrada en llamadas posteriores, si es necesario.
- bytesWritten
- Int32
Cuando este método vuelve, contiene el número de bytes escritos en el intervalo de salida. Esto puede usarse para segmentar la salida en llamadas posteriores, si es necesario.
- isFinalBlock
- Boolean
true
(valor predeterminado) para indicar que el intervalo de entrada contiene todos los datos que se van a codificar. false
para indicar que el intervalo de entrada contiene datos parciales con más datos que seguir.
Devoluciones
Uno de los valores de enumeración que indica el estado de la operación de codificación.
Comentarios
El valor devuelto puede ser el siguiente:
- OperationStatus.Done: el procesamiento de todo el intervalo de entrada se realizó correctamente.
- OperationStatus.DestinationTooSmall: no hay suficiente espacio en el intervalo de salida para ajustarse a la entrada codificada.
- OperationStatus.NeedMoreData:
isFinalBlock
esfalse
. De lo contrario, siisFinalBlock
estrue
, la salida se rellena si la entrada no es un múltiplo de 3.
Este método no puede devolverse OperationStatus.InvalidData , ya que no es posible para la codificación base 64.