Base64Url.DecodeFromUtf8 Methode

Definition

Namespace:

System.Buffers.Text

Assembly:

System.Runtime.dll

Überlädt

DecodeFromUtf8(ReadOnlySpan<Byte>)	Decodiert die Spanne von UTF-8-codierten Text, der als Base64Url dargestellt wird, in Binärdaten.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)	Decodiert die Spanne von UTF-8-codierten Text, der als Base64Url dargestellt wird, in Binärdaten.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)	Decodiert die Spanne von UTF-8-codierten Text, der als Base64Url dargestellt wird, in Binärdaten.

DecodeFromUtf8(ReadOnlySpan<Byte>)

Decodiert die Spanne von UTF-8-codierten Text, der als Base64Url dargestellt wird, in Binärdaten.

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

Parameter

source

ReadOnlySpan<Byte>

Die Eingabespanne, die UTF-8-codierten Text in Base64Url enthält, der decodiert werden muss.

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.

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

Decodiert die Spanne von UTF-8-codierten Text, der als Base64Url dargestellt wird, in Binärdaten.

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

Parameter

source

ReadOnlySpan<Byte>

Die Eingabespanne, die UTF-8-codierten Text in Base64Url enthält, der decodiert werden muss.

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 destinationgeschriebenen 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.

Hinweise

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

Wenn die source Länge kein Vielfaches von 4 ist, decodiert die Restlichen entsprechend:

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

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

- Rest von 1 Byte - ist ungültige Eingabe, verursacht FormatException.

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

Decodiert die Spanne von UTF-8-codierten Text, der als Base64Url dargestellt wird, in Binärdaten.

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

Parameter

source

ReadOnlySpan<Byte>

Die Eingabespanne, die UTF-8-codierten Text in Base64Url enthält, der decodiert werden muss.

destination

Span<Byte>

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

bytesConsumed

Int32

Wenn diese Methode zurückgegeben wird, enthält sie die Anzahl der während des Vorgangs verbrauchten Eingabebytes. 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 Bytes - decodiert in 2 Byte Daten, Decodierung erfolgreich.

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

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