Base64Url.DecodeFromUtf8 Méthode

Définition

Espace de noms:

System.Buffers.Text

Assembly:

System.Runtime.dll

Surcharges

DecodeFromUtf8(ReadOnlySpan<Byte>)	Décode l’étendue du texte encodé UTF-8 représenté en base64Url en données binaires.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)	Décode l’étendue du texte encodé UTF-8 représenté en base64Url en données binaires.
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)	Décode l’étendue du texte encodé UTF-8 représenté en base64Url en données binaires.

DecodeFromUtf8(ReadOnlySpan<Byte>)

Décode l’étendue du texte encodé UTF-8 représenté en base64Url en données binaires.

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

Paramètres

source

ReadOnlySpan<Byte>

Étendue d’entrée qui contient du texte codé en UTF-8 dans Base64Url qui doit être décodé.

Retours

Byte[]

>tableau d’octets qui contient le résultat de l’opération de décodage.

Exceptions

FormatException

source contient un caractère Base64Url non valide,

plus de deux caractères de remplissage ou un espace non blanc parmi les caractères de remplissage.

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

Décode l’étendue du texte encodé UTF-8 représenté en base64Url en données binaires.

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

Paramètres

source

ReadOnlySpan<Byte>

Étendue d’entrée qui contient du texte codé en UTF-8 dans Base64Url qui doit être décodé.

destination

Span<Byte>

Étendue de sortie qui contient le résultat de l’opération, c’est-à-dire les données binaires décodées.

Retours

Int32

Nombre d’octets écrits en destination. Cela peut être utilisé pour découper la sortie pour les appels suivants, si nécessaire.

Exceptions

ArgumentException

La mémoire tampon dans destination est trop petite pour contenir la sortie encodée.

FormatException

source contient un caractère Base64Url non valide,

plus de deux caractères de remplissage ou un espace non blanc parmi les caractères de remplissage.

Remarques

Comme le remplissage est facultatif pour Base64Url, la longueur source ne doit pas être un multiple de 4.

Si la longueur source n’est pas un multiple de 4 les restes décodés en conséquence :

- Le reste de 3 octets - décodé en 2 octets de données, le décodage réussit.

- Reste de 2 octets - décodé en données d’octets. le décodage réussit.

- Le reste de 1 octet - n’est pas valide en entrée, provoque l’exception FormatException.

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

Décode l’étendue du texte encodé UTF-8 représenté en base64Url en données binaires.

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

Paramètres

source

ReadOnlySpan<Byte>

Étendue d’entrée qui contient du texte codé en UTF-8 dans Base64Url qui doit être décodé.

destination

Span<Byte>

Étendue de sortie qui contient le résultat de l’opération, c’est-à-dire les données binaires décodées.

bytesConsumed

Int32

Lorsque cette méthode est retournée, contient le nombre d’octets d’entrée consommés pendant l’opération. Cela peut être utilisé pour découper l’entrée pour les appels suivants, si nécessaire. Ce paramètre est traité comme non initialisé.

bytesWritten

Int32

Lorsque cette méthode est retournée, contient le nombre d’octets écrits dans l’étendue de sortie. Cela peut être utilisé pour découper la sortie pour les appels suivants, si nécessaire. Ce paramètre est traité comme non initialisé.

isFinalBlock

Boolean

true lorsque l’étendue d’entrée contient l’intégralité des données à encoder ; false lorsque d’autres données peuvent suivre,

par exemple lors de l’appel dans une boucle. Les appels avec false doivent être suivis d’un autre appel où ce paramètre est true appel. La valeur par défaut est true.

Retours

OperationStatus

Une des valeurs d’énumération qui indique la réussite ou l’échec de l’opération.

Remarques

Comme le remplissage est facultatif pour Base64Url, la longueur source ne doit pas être un multiple de 4, même si isFinalBlock est true.

Si la longueur source n’est pas un multiple de 4 et isFinalBlock est true les restes décodés en conséquence :

- Le reste de 3 octets - décodé en 2 octets de données, le décodage réussit.

- Reste de 2 octets - décodé en données d’octets. le décodage réussit.

- Le reste de 1 octets entraîne le résultat OperationStatus.InvalidData.