Base64Url.DecodeFromUtf8 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í.
Sobrecargas
| Nombre | Description |
|---|---|
| DecodeFromUtf8(ReadOnlySpan<Byte>) |
Descodifica el intervalo de texto codificado UTF-8 representado como Base64Url en datos binarios. |
| DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>) |
Descodifica el intervalo de texto codificado UTF-8 representado como Base64Url en datos binarios. |
| DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean) |
Descodifica el intervalo de texto codificado UTF-8 representado como Base64Url en datos binarios. |
DecodeFromUtf8(ReadOnlySpan<Byte>)
- Source:
- Base64UrlDecoder.cs
- Source:
- Base64UrlDecoder.cs
Descodifica el intervalo de texto codificado UTF-8 representado como Base64Url en datos binarios.
public:
static cli::array <System::Byte> ^ DecodeFromUtf8(ReadOnlySpan<System::Byte> source);
public static byte[] DecodeFromUtf8(ReadOnlySpan<byte> source);
static member DecodeFromUtf8 : ReadOnlySpan<byte> -> byte[]
Public Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte)) As Byte()
Parámetros
- source
- ReadOnlySpan<Byte>
Intervalo de entrada que contiene texto codificado UTF-8 en Base64Url que debe descodificarse.
Devoluciones
>matriz de bytes que contiene el resultado de la operación de descodificación.
Excepciones
source contiene un carácter Base64Url no válido,
más de dos caracteres de relleno o un carácter de espacio no en blanco entre los caracteres de relleno.
Se aplica a
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)
- Source:
- Base64UrlDecoder.cs
- Source:
- Base64UrlDecoder.cs
Descodifica el intervalo de texto codificado UTF-8 representado como Base64Url en datos binarios.
public:
static int DecodeFromUtf8(ReadOnlySpan<System::Byte> source, Span<System::Byte> destination);
public static int DecodeFromUtf8(ReadOnlySpan<byte> source, Span<byte> destination);
static member DecodeFromUtf8 : ReadOnlySpan<byte> * Span<byte> -> int
Public Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte), destination As Span(Of Byte)) As Integer
Parámetros
- source
- ReadOnlySpan<Byte>
Intervalo de entrada que contiene texto codificado UTF-8 en Base64Url que debe descodificarse.
Intervalo de salida que contiene el resultado de la operación, es decir, los datos binarios descodificados.
Devoluciones
Número de bytes escritos en destination. Esto se puede usar para segmentar la salida de las llamadas posteriores, si es necesario.
Excepciones
El búfer de destination es demasiado pequeño para contener la salida codificada.
source contiene un carácter Base64Url no válido,
más de dos caracteres de relleno o un carácter de espacio no en blanco entre los caracteres de relleno.
Comentarios
Como relleno es opcional para Base64Url, no es necesario que la longitud del source sea un múltiplo de 4.
Si la longitud del source no es un múltiplo de 4, los restos descodificados en consecuencia:
- Resto de 3 bytes: descodificado en 2 bytes, la descodificación se realiza correctamente.
- Resto de 2 bytes: descodificado en 1 datos de bytes. la descodificación se realiza correctamente.
- Resto de 1 byte: no es entrada válida, provoca FormatException.
Se aplica a
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)
- Source:
- Base64UrlDecoder.cs
- Source:
- Base64UrlDecoder.cs
Descodifica el intervalo de texto codificado UTF-8 representado como Base64Url en datos binarios.
public static System.Buffers.OperationStatus DecodeFromUtf8(ReadOnlySpan<byte> source, Span<byte> destination, out int bytesConsumed, out int bytesWritten, bool isFinalBlock = true);
static member DecodeFromUtf8 : ReadOnlySpan<byte> * Span<byte> * int * int * bool -> System.Buffers.OperationStatus
Public Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte), destination As Span(Of Byte), ByRef bytesConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus
Parámetros
- source
- ReadOnlySpan<Byte>
Intervalo de entrada que contiene texto codificado UTF-8 en Base64Url que debe descodificarse.
Intervalo de salida que contiene el resultado de la operación, es decir, los datos binarios descodificados.
- bytesConsumed
- Int32
Cuando este método devuelve, contiene el número de bytes de entrada consumidos durante la operación. Esto se puede usar para segmentar la entrada para las llamadas posteriores, si es necesario. Este parámetro se trata como sin inicializar.
- bytesWritten
- Int32
Cuando este método devuelve, contiene el número de bytes escritos en el intervalo de salida. Esto se puede usar para segmentar la salida de las llamadas posteriores, si es necesario. Este parámetro se trata como sin inicializar.
- isFinalBlock
- Boolean
true cuando el intervalo de entrada contiene la totalidad de los datos que se van a codificar; false cuando se pueden seguir más datos,
por ejemplo, al llamar a en un bucle. Las llamadas con false deben seguirse con otra llamada en la que este parámetro es true llamada. El valor predeterminado es true.
Devoluciones
Uno de los valores de enumeración que indica el éxito o error de la operación.
Comentarios
Como relleno es opcional para Base64Url, no es necesario que la longitud de source sea un múltiplo de 4 incluso si isFinalBlock es true.
Si la longitud del source no es un múltiplo de 4 y isFinalBlock se true los restos descodificados en consecuencia:
- Resto de 3 bytes: descodificado en 2 bytes, la descodificación se realiza correctamente.
- Resto de 2 bytes: descodificado en 1 datos de bytes. la descodificación se realiza correctamente.
- Resto de 1 byte: provocará el resultado OperationStatus.InvalidData.