Utf8.ToUtf16 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.
Convertit une plage d’octets en lecture seule encodés en UTF-8 en une plage de caractères encodés en UTF-16.
public static System.Buffers.OperationStatus ToUtf16 (ReadOnlySpan<byte> source, Span<char> destination, out int bytesRead, out int charsWritten, bool replaceInvalidSequences = true, bool isFinalBlock = true);static member ToUtf16 : ReadOnlySpan<byte> * Span<char> * int * int * bool * bool -> System.Buffers.OperationStatusPublic Shared Function ToUtf16 (source As ReadOnlySpan(Of Byte), destination As Span(Of Char), ByRef bytesRead As Integer, ByRef charsWritten As Integer, Optional replaceInvalidSequences As Boolean = true, Optional isFinalBlock As Boolean = true) As OperationStatusParamètres
- source
- ReadOnlySpan<Byte>
Plage d’octets encodés au format UTF-8 en lecture seule.
- bytesRead
- Int32
Quand la méthode retourne, le nombre de caractères lus depuis source.
- charsWritten
- Int32
Quand la méthode retourne, le nombre de caractères écrits dans destination.
- replaceInvalidSequences
- Boolean
true pour remplacer les séquences UTF-8 non valides dans source par U+FFFD ; false pour retourner InvalidData si des caractères non valides sont trouvés dans source.
- isFinalBlock
- Boolean
true si la méthode ne doit pas retourner NeedMoreData ; sinon, false.
Retours
Valeur qui indique l’état de la conversion.
Remarques
Cette méthode correspond à la méthode UTF8Encoding.GetChars , sauf qu’elle a une convention d’appel différente, des mécanismes de gestion des erreurs différents et des caractéristiques de performances différentes.
Si « replaceInvalidSequences » est true, la méthode remplace toutes les sous-séquences mal formées dans source par U+FFFD dans destination et continue à traiter le reste de la mémoire tampon. Sinon, la méthode retourne OperationStatus.InvalidData si elle rencontre des séquences mal formées.
Si la méthode retourne un code d’erreur, les paramètres de sortie indiquent la quantité de données correctement transcodées, et l’emplacement de la sous-séquence mal formée peut être déduit à partir de ces valeurs.
Si 'replaceInvalidSequences' est true, la méthode ne retourne OperationStatus.InvalidDatajamais . Si 'isFinalBlock' est true, la méthode ne retourne OperationStatus.NeedMoreDatajamais .
