Base64Url.DecodeFromChars Methode

Definition

Namespace:

System.Buffers.Text

Assembly:

System.Runtime.dll

Überlädt

DecodeFromChars(ReadOnlySpan<Char>)	Decodiert die Spanne von Unicode-ASCII-Zeichen, die als Base64Url dargestellt werden, in Binärdaten.
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>)	Decodiert die Spanne von Unicode-ASCII-Zeichen, die als Base64Url dargestellt werden, in Binärdaten.
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>, Int32, Int32, Boolean)	Decodiert die Spanne von Unicode-ASCII-Zeichen, die als Base64Url dargestellt werden, in Binärdaten.

DecodeFromChars(ReadOnlySpan<Char>)

Decodiert die Spanne von Unicode-ASCII-Zeichen, die als Base64Url dargestellt werden, in Binärdaten.

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

Parameter

source

ReadOnlySpan<Char>

Die Eingabespanne, die ASCII-Zeichen in Base64Url enthält, die decodiert werden müssen.

Gibt zurück

Byte[]

Ein Bytearray, das das Ergebnis des Decodierungsvorgangs enthält.

Ausnahmen

FormatException

source enthält ein ungültiges Base64Url-Zeichen,

mehr als zwei Abstandszeichen oder ein Leerzeichen zwischen den Abstandszeichen.

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

Decodiert die Spanne von Unicode-ASCII-Zeichen, die als Base64Url dargestellt werden, in Binärdaten.

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

Parameter

source

ReadOnlySpan<Char>

Die Eingabespanne, die ASCII-Zeichen in Base64Url enthält, die decodiert werden müssen.

destination

Span<Byte>

Die Ausgabespanne, die das Ergebnis des Vorgangs enthält, d. h. die decodierten Binärdaten.

Gibt zurück

Int32

Die Anzahl der in die Ausgabespanne geschriebenen Bytes. Dies kann verwendet werden, um die Ausgabe für nachfolgende Aufrufe zu segmentieren, falls erforderlich.

Ausnahmen

ArgumentException

Der Puffer in destination ist zu klein, um die codierte Ausgabe zu halten.

FormatException

source enthält ein ungültiges Base64Url-Zeichen,

mehr als zwei Abstandszeichen oder ein Leerzeichen zwischen den Abstandszeichen.

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

Decodiert die Spanne von Unicode-ASCII-Zeichen, die als Base64Url dargestellt werden, in Binärdaten.

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

Parameter

source

ReadOnlySpan<Char>

Die Eingabespanne, die Unicode-ASCII-Zeichen in Base64Url enthält, die decodiert werden müssen.

destination

Span<Byte>

Die Ausgabespanne, die das Ergebnis des Vorgangs enthält, d. h. die decodierten Binärdaten.

charsConsumed

Int32

Wenn diese Methode zurückgegeben wird, enthält sie die Anzahl der während des Vorgangs verbrauchten Eingabezeichen. Dies kann verwendet werden, um die Eingabe für nachfolgende Aufrufe zu segmentieren, falls erforderlich. Dieser Parameter wird als nicht initialisiert behandelt.

bytesWritten

Int32

Wenn diese Methode zurückgegeben wird, enthält die Anzahl der Bytes, die in die Ausgabespanne geschrieben wurden. Dies kann verwendet werden, um die Ausgabe für nachfolgende Aufrufe zu segmentieren, falls erforderlich. Dieser Parameter wird als nicht initialisiert behandelt.

isFinalBlock

Boolean

true, wenn die Eingabespanne die gesamte zu codierenden Daten enthält; false, wenn weitere Daten folgen können,

z. B. beim Aufrufen in einer Schleife. Aufrufe mit false sollten mit einem anderen Aufruf verfolgt werden, bei dem dieser Parameter true Aufruf ist. Der Standardwert ist true.

Gibt zurück

OperationStatus

Einer der Enumerationswerte, der den Erfolg oder Fehler des Vorgangs angibt.

Hinweise

Da der Abstand für Base64Url optional ist, muss die source Länge kein Vielfaches von 4 sein, auch wenn isFinalBlocktrueist.

Wenn die source Länge kein Vielfaches von 4 ist und isFinalBlock entsprechend true die Restlichen decodiert werden:

- Rest von 3 Zeichen - decodiert in 2 Byte-Daten, Decodierung erfolgreich.

- Rest von 2 Zeichen - decodiert in 1 Byte-Daten. Die Decodierung ist erfolgreich.

- Rest von 1 Zeichen - bewirkt OperationStatus.InvalidData-Ergebnis.