Base64Url.DecodeFromUtf8 Método

Definição

Namespace:

System.Buffers.Text

Assembly:

System.Runtime.dll

Sobrecargas

DecodeFromUtf8(ReadOnlySpan<Byte>)	Decodifica o intervalo de texto codificado em UTF-8 representado como Base64Url em dados binários.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)	Decodifica o intervalo de texto codificado em UTF-8 representado como Base64Url em dados binários.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)	Decodifica o intervalo de texto codificado em UTF-8 representado como Base64Url em dados binários.

DecodeFromUtf8(ReadOnlySpan<Byte>)

Decodifica o intervalo de texto codificado em UTF-8 representado como Base64Url em dados binários.

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>

O intervalo de entrada que contém texto codificado em UTF-8 em Base64Url que precisa ser decodificado.

Retornos

Byte[]

>uma matriz de bytes que contém o resultado da operação de decodificação.

Exceções

FormatException

source contém um caractere Base64Url inválido,

mais de dois caracteres de preenchimento ou um caractere de espaço não branco entre os caracteres de preenchimento.

DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)

Decodifica o intervalo de texto codificado em UTF-8 representado como Base64Url em dados binários.

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>

O intervalo de entrada que contém texto codificado em UTF-8 em Base64Url que precisa ser decodificado.

destination

Span<Byte>

O intervalo de saída que contém o resultado da operação, ou seja, os dados binários decodificados.

Retornos

Int32

O número de bytes gravados em destination. Isso pode ser usado para fatiar a saída para chamadas subsequentes, se necessário.

Exceções

ArgumentException

O buffer em destination é muito pequeno para manter a saída codificada.

FormatException

source contém um caractere Base64Url inválido,

mais de dois caracteres de preenchimento ou um caractere de espaço não branco entre os caracteres de preenchimento.

Comentários

Como o preenchimento é opcional para Base64Url, o comprimento source não necessário para ser um múltiplo de 4.

Se o comprimento source não for um múltiplo de 4, os restantes serão decodificados adequadamente:

– Restante de 3 bytes – decodificados em dados de 2 bytes, a decodificação é bem-sucedida.

- Restante de 2 bytes - decodificados em 1 dados de byte. A decodificação é bem-sucedida.

- O restante de 1 byte - é uma entrada inválida, causa FormatException.

DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)

Decodifica o intervalo de texto codificado em UTF-8 representado como Base64Url em dados binários.

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>

O intervalo de entrada que contém texto codificado em UTF-8 em Base64Url que precisa ser decodificado.

destination

Span<Byte>

O intervalo de saída que contém o resultado da operação, ou seja, os dados binários decodificados.

bytesConsumed

Int32

Quando esse método é retornado, contém o número de bytes de entrada consumidos durante a operação. Isso pode ser usado para dividir a entrada para chamadas subsequentes, se necessário. Esse parâmetro é tratado como não inicializado.

bytesWritten

Int32

Quando esse método é retornado, 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. Esse parâmetro é tratado como não inicializado.

isFinalBlock

Boolean

true quando o intervalo de entrada contém a totalidade dos dados a serem codificados; false quando mais dados podem ser seguidos,

como ao chamar em um loop. Chamadas com false devem ser seguidas com outra chamada em que esse parâmetro é true chamada. O padrão é true.

Retornos

OperationStatus

Um dos valores de enumeração que indica o êxito ou a falha da operação.

Comentários

Como o preenchimento é opcional para Base64Url, o comprimento source não é necessário para ser um múltiplo de 4, mesmo que isFinalBlock seja true.

Se o comprimento source não for um múltiplo de 4 e isFinalBlock for true os restantes decodificados adequadamente:

– Restante de 3 bytes – decodificados em dados de 2 bytes, a decodificação é bem-sucedida.

- Restante de 2 bytes - decodificados em 1 dados de byte. A decodificação é bem-sucedida.

- Restante de 1 byte - causará o resultado de OperationStatus.InvalidData.