Utf8.FromUtf16 Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte um intervalo de caracteres UTF-16 em um intervalo de bytes codificados por UTF-8.
public static System.Buffers.OperationStatus FromUtf16 (ReadOnlySpan<char> source, Span<byte> destination, out int charsRead, out int bytesWritten, bool replaceInvalidSequences = true, bool isFinalBlock = true);static member FromUtf16 : ReadOnlySpan<char> * Span<byte> * int * int * bool * bool -> System.Buffers.OperationStatusPublic Shared Function FromUtf16 (source As ReadOnlySpan(Of Char), destination As Span(Of Byte), ByRef charsRead As Integer, ByRef bytesWritten As Integer, Optional replaceInvalidSequences As Boolean = true, Optional isFinalBlock As Boolean = true) As OperationStatusParâmetros
- source
- ReadOnlySpan<Char>
Um intervalo de caracteres somente leitura codificado por UTF-16.
- charsRead
- Int32
Quando o método é retornado, o número de caracteres lidos de source.
- bytesWritten
- Int32
Quando o método é retornado, o número de bytes gravados em destination.
- replaceInvalidSequences
- Boolean
true para substituir sequências UTF-16 inválidas no source por U+FFFD; false para retornar InvalidData se forem encontrados caracteres inválidos no source.
- isFinalBlock
- Boolean
true se o método não deve retornar NeedMoreData; caso contrário, false.
Retornos
Um valor que indica esse status da conversão.
Comentários
Esse método corresponde ao método UTF8Encoding.GetBytes , exceto que ele tem uma convenção de chamada diferente, diferentes mecanismos de tratamento de erros e características de desempenho diferentes.
Se 'replaceInvalidSequences' for true, o método substituirá quaisquer subsequências mal formadas source por U+FFFD destination e continuará processando o restante do buffer. Caso contrário, o método retornará OperationStatus.InvalidData se encontrar sequências mal formadas.
Se o método retornar um código de erro, os parâmetros externos indicarão quanto dos dados foram transcodificados com êxito e o local da subsequenteuência mal formada poderá ser deduzido desses valores.
Se 'replaceInvalidSequences' for true, o método nunca retornará OperationStatus.InvalidData. Se 'isFinalBlock' for true, o método nunca retornará OperationStatus.NeedMoreData.