Utf8.ToUtf16 Méthode

Définition

Espace de noms:

System.Text.Unicode

Assembly:

System.Runtime.dll

Source:

Utf8.cs

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

Public 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 OperationStatus

Paramètres

source

ReadOnlySpan<Byte>

Plage d’octets encodés au format UTF-8 en lecture seule.

destination

Span<Char>

Plage de caractères encodés au format UTF-16.

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

OperationStatus

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 .