Base64Url.DecodeFromChars Método

Definição

Namespace:

System.Buffers.Text

Assembly:

System.Runtime.dll

Sobrecargas

DecodeFromChars(ReadOnlySpan<Char>)	Decodifica o intervalo de caracteres ASCII unicode representados como Base64Url em dados binários.
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>)	Decodifica o intervalo de caracteres ASCII unicode representados como Base64Url em dados binários.
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>, Int32, Int32, Boolean)	Decodifica o intervalo de caracteres ASCII unicode representados como Base64Url em dados binários.

DecodeFromChars(ReadOnlySpan<Char>)

Decodifica o intervalo de caracteres ASCII unicode representados como Base64Url em dados binários.

public:
 static cli::array <System::Byte> ^ DecodeFromChars(ReadOnlySpan<char> source);

public static byte[] DecodeFromChars (ReadOnlySpan<char> source);

static member DecodeFromChars : ReadOnlySpan<char> -> byte[]

Public Shared Function DecodeFromChars (source As ReadOnlySpan(Of Char)) As Byte()

Parâmetros

source

ReadOnlySpan<Char>

O intervalo de entrada que contém caracteres ASCII 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.

DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>)

Decodifica o intervalo de caracteres ASCII unicode representados como Base64Url em dados binários.

public:
 static int DecodeFromChars(ReadOnlySpan<char> source, Span<System::Byte> destination);

public static int DecodeFromChars (ReadOnlySpan<char> source, Span<byte> destination);

static member DecodeFromChars : ReadOnlySpan<char> * Span<byte> -> int

Public Shared Function DecodeFromChars (source As ReadOnlySpan(Of Char), destination As Span(Of Byte)) As Integer

Parâmetros

source

ReadOnlySpan<Char>

O intervalo de entrada que contém caracteres ASCII 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 no intervalo de saída. 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.

DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>, Int32, Int32, Boolean)

Decodifica o intervalo de caracteres ASCII unicode representados como Base64Url em dados binários.

public static System.Buffers.OperationStatus DecodeFromChars (ReadOnlySpan<char> source, Span<byte> destination, out int charsConsumed, out int bytesWritten, bool isFinalBlock = true);

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

Public Shared Function DecodeFromChars (source As ReadOnlySpan(Of Char), destination As Span(Of Byte), ByRef charsConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus

Parâmetros

source

ReadOnlySpan<Char>

O intervalo de entrada que contém caracteres ASCII unicode em Base64Url que precisam ser decodificados.

destination

Span<Byte>

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

charsConsumed

Int32

Quando esse método é retornado, contém o número de caracteres 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 caracteres - decodificados em dados de 2 bytes, a decodificação é bem-sucedida.

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

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