Base64Url.DecodeFromChars Metoda

Definicja

Przestrzeń nazw:

System.Buffers.Text

Zestaw:

System.Runtime.dll

Przeciążenia

DecodeFromChars(ReadOnlySpan<Char>)	Dekoduje zakres znaków Unicode ASCII reprezentowanych jako Base64Url do danych binarnych.
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>)	Dekoduje zakres znaków Unicode ASCII reprezentowanych jako Base64Url do danych binarnych.
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>, Int32, Int32, Boolean)	Dekoduje zakres znaków Unicode ASCII reprezentowanych jako Base64Url do danych binarnych.

DecodeFromChars(ReadOnlySpan<Char>)

Dekoduje zakres znaków Unicode ASCII reprezentowanych jako Base64Url do danych binarnych.

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

Parametry

source

ReadOnlySpan<Char>

Zakres danych wejściowych zawierający znaki ASCII w elemencie Base64Url, który musi zostać zdekodowany.

Zwraca

Byte[]

Tablica bajtów zawierająca wynik operacji dekodowania.

Wyjątki

FormatException

source zawiera nieprawidłowy znak Base64Url,

więcej niż dwa znaki wypełnienia lub znak inny niż biały znak między znakami dopełnienia.

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

Dekoduje zakres znaków Unicode ASCII reprezentowanych jako Base64Url do danych binarnych.

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

Parametry

source

ReadOnlySpan<Char>

Zakres danych wejściowych zawierający znaki ASCII w elemencie Base64Url, który musi zostać zdekodowany.

destination

Span<Byte>

Zakres danych wyjściowych, który zawiera wynik operacji, tj. zdekodowane dane binarne.

Zwraca

Int32

Liczba bajtów zapisanych w zakresie danych wyjściowych. Może to służyć do fragmentowania danych wyjściowych dla kolejnych wywołań, w razie potrzeby.

Wyjątki

ArgumentException

Bufor w destination jest zbyt mały, aby przechowywać zakodowane dane wyjściowe.

FormatException

source zawiera nieprawidłowy znak Base64Url,

więcej niż dwa znaki wypełnienia lub znak inny niż biały znak między znakami dopełnienia.

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

Dekoduje zakres znaków Unicode ASCII reprezentowanych jako Base64Url do danych binarnych.

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

Parametry

source

ReadOnlySpan<Char>

Zakres danych wejściowych zawierający znaki Unicode ASCII w elemencie Base64Url, który musi zostać zdekodowany.

destination

Span<Byte>

Zakres danych wyjściowych, który zawiera wynik operacji, tj. zdekodowane dane binarne.

charsConsumed

Int32

Gdy ta metoda zwróci wartość , zawiera liczbę znaków wejściowych użytych podczas operacji. Może to służyć do fragmentowania danych wejściowych dla kolejnych wywołań, w razie potrzeby. Ten parametr jest traktowany jako niezainicjowany.

bytesWritten

Int32

Gdy ta metoda zwróci wartość , zawiera liczbę bajtów zapisanych w zakresie danych wyjściowych. Może to służyć do fragmentowania danych wyjściowych dla kolejnych wywołań, w razie potrzeby. Ten parametr jest traktowany jako niezainicjowany.

isFinalBlock

Boolean

true, gdy zakres danych wejściowych zawiera całe dane do zakodowania; false, gdy może wystąpić więcej danych,

na przykład podczas wywoływania w pętli. Wywołania z false należy wykonać za pomocą innego wywołania, w którym ten parametr jest true wywołania. Wartość domyślna to true.

Zwraca

OperationStatus

Jedna z wartości wyliczenia wskazująca powodzenie lub niepowodzenie operacji.

Uwagi

Ponieważ dopełnienie jest opcjonalne dla parametru Base64Url, długość source nie jest wymagana do wielokrotności 4, nawet jeśli isFinalBlock jest true.

Jeśli długość source nie jest wielokrotna 4 i isFinalBlock jest true pozostałe odpowiednio zdekodowane:

- Pozostała część 3 znaków — dekodowana do 2 bajtów danych, dekodowanie powiedzie się.

- Pozostała część 2 znaków — zdekodowana do 1 bajtów danych. dekodowanie powiedzie się.

- Pozostała część 1 znaków — spowoduje wynik OperationStatus.InvalidData.