Base64Url.DecodeFromUtf8 Metoda

Definice

Obor názvů:

System.Buffers.Text

Sestavení:

Microsoft.Bcl.Memory.dll

Balíček:

Microsoft.Bcl.Memory v9.0.0-rc.2.24473.5

Přetížení

DecodeFromUtf8(ReadOnlySpan<Byte>)	Dekóduje rozsah kódování UTF-8 text reprezentovaný jako Base64Url do binárních dat.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)	Dekóduje rozsah kódování UTF-8 text reprezentovaný jako Base64Url do binárních dat.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)	Dekóduje rozsah kódování UTF-8 text reprezentovaný jako Base64Url do binárních dat.

DecodeFromUtf8(ReadOnlySpan<Byte>)

Zdroj:

Base64UrlDecoder.cs

Dekóduje rozsah kódování UTF-8 text reprezentovaný jako Base64Url do binárních dat.

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()

Parametry

source

ReadOnlySpan<Byte>

Vstupní rozsah, který obsahuje kódovaný text UTF-8 v base64Url, který je potřeba dekódovat.

Návraty

Byte[]

>Pole bajtů, které obsahuje výsledek operace dekódování.

Výjimky

FormatException

source obsahuje neplatný znak Base64Url.

více než dva odsazení znaků nebo znak prázdné mezery mezi znaky odsazení.

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

Zdroj:

Base64UrlDecoder.cs

Dekóduje rozsah kódování UTF-8 text reprezentovaný jako Base64Url do binárních dat.

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

Parametry

source

ReadOnlySpan<Byte>

Vstupní rozsah, který obsahuje kódovaný text UTF-8 v base64Url, který je potřeba dekódovat.

destination

Span<Byte>

Výstupní rozsah, který obsahuje výsledek operace, tj. dekódovaná binární data.

Návraty

Int32

Počet bajtů zapsaných do destination. V případě potřeby se dá použít k průřezu výstupu pro následná volání.

Výjimky

ArgumentException

Vyrovnávací paměť v destination je příliš malá pro uložení zakódovaného výstupu.

FormatException

source obsahuje neplatný znak Base64Url.

více než dva odsazení znaků nebo znak prázdné mezery mezi znaky odsazení.

Poznámky

Protože odsazení je volitelné pro base64Url délku source nemusí být násobkem 4.

Pokud délka source není násobkem 4 zbytek odpovídajícím způsobem dekódován:

- Zbytek 3 bajtů - dekódován na 2 bajty data, dekódování proběhne úspěšně.

- Zbytek 2 bajtů - dekódován na 1 bajtová data. dekódování proběhne úspěšně.

– Zbytek 1 bajtů – je neplatný vstup, způsobuje výjimku FormatException.

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

Zdroj:

Base64UrlDecoder.cs

Dekóduje rozsah kódování UTF-8 text reprezentovaný jako Base64Url do binárních dat.

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

Parametry

source

ReadOnlySpan<Byte>

Vstupní rozsah, který obsahuje kódovaný text UTF-8 v base64Url, který je potřeba dekódovat.

destination

Span<Byte>

Výstupní rozsah, který obsahuje výsledek operace, tj. dekódovaná binární data.

bytesConsumed

Int32

Pokud tato metoda vrátí, obsahuje počet vstupních bajtů spotřebovaných během operace. To se dá použít k průřezu vstupu pro následná volání, pokud je to potřeba. Tento parametr se považuje za neinicializovaný.

bytesWritten

Int32

Když tato metoda vrátí, obsahuje počet bajtů zapsaných do výstupního rozsahu. V případě potřeby se dá použít k průřezu výstupu pro následná volání. Tento parametr se považuje za neinicializovaný.

isFinalBlock

Boolean

true, když vstupní rozsah obsahuje celé množství dat, která se mají kódovat; false, když může následovat více dat,

například při volání ve smyčce. Volání s false by se měla provést dalším voláním, ve kterém je tento parametr true volání. Výchozí hodnota je true.

Návraty

OperationStatus

Jedna z hodnot výčtu, která označuje úspěch nebo selhání operace.

Poznámky

Protože odsazení je volitelné pro Base64Url délka source nemusí být násobkem 4, i když isFinalBlock je true.

Pokud délka source není násobkem 4 a isFinalBlock je true zbytek dekódován odpovídajícím způsobem:

- Zbytek 3 bajtů - dekódován na 2 bajty data, dekódování proběhne úspěšně.

- Zbytek 2 bajtů - dekódován na 1 bajtová data. dekódování proběhne úspěšně.

- Zbytek 1 bajtů – způsobí výsledek OperationStatus.InvalidData.