Base64.EncodeToUtf8 Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Code l’étendue des données binaires en texte codé UTF-8 représenté en tant que base 64.
public static System.Buffers.OperationStatus EncodeToUtf8 (ReadOnlySpan<byte> bytes, Span<byte> utf8, out int bytesConsumed, out int bytesWritten, bool isFinalBlock = true);
static member EncodeToUtf8 : ReadOnlySpan<byte> * Span<byte> * int * int * bool -> System.Buffers.OperationStatus
Public Shared Function EncodeToUtf8 (bytes As ReadOnlySpan(Of Byte), utf8 As Span(Of Byte), ByRef bytesConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus
Paramètres
- bytes
- ReadOnlySpan<Byte>
L’étendue d’entrée qui contient les données binaires qui doivent être codées.
L’étendue de sortie qui contient le résultat de l’opération, autrement dit, le texte codé UTF-8 en base 64.
- 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 servir à découper l’entrée pour les appels suivants, si nécessaire.
- bytesWritten
- Int32
Lorsque cette méthode est retournée, contient le nombre d’octets écrits dans l’étendue de sortie. Cela peut servir à découper la sortie pour les appels suivants, si nécessaire.
- isFinalBlock
- Boolean
true
(valeur par défaut) pour indiquer que l’étendue d’entrée contient l’intégralité des données à encoder. false
pour indiquer que l’étendue d’entrée contient des données partielles avec d’autres données à suivre.
Retours
L'une des valeurs d’énumération qui indique l’état de l’opération de codage.
Remarques
La valeur de retour peut être la suivante :
- OperationStatus.Done: Le traitement de l’ensemble de l’étendue d’entrée a réussi.
- OperationStatus.DestinationTooSmall: il n’y a pas suffisamment d’espace dans l’étendue de sortie pour s’adapter à l’entrée encodée.
- OperationStatus.NeedMoreData:
isFinalBlock
estfalse
. Sinon, siisFinalBlock
atrue
la valeur , la sortie est remplie si l’entrée n’est pas un multiple de 3.
Cette méthode ne peut pas être retournée OperationStatus.InvalidData , car cela n’est pas possible pour l’encodage en base 64.