Utf8.FromUtf16 Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengonversi rentang karakter UTF-16 ke rentang byte yang dikodekan 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.OperationStatus
Public 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 OperationStatus
Parameter
- source
- ReadOnlySpan<Char>
Rentang karakter baca-saja yang dikodekan UTF-16.
- charsRead
- Int32
Saat metode kembali, jumlah karakter yang dibaca dari source.
- bytesWritten
- Int32
Ketika metode kembali, jumlah byte yang ditulis ke destination.
- replaceInvalidSequences
- Boolean
true untuk mengganti urutan UTF-16 yang tidak valid dengan source U+FFFD; false untuk mengembalikan InvalidData jika karakter yang tidak valid ditemukan di source.
- isFinalBlock
- Boolean
true jika metode tidak boleh mengembalikan NeedMoreData; jika tidak, false.
Mengembalikan
Nilai yang menunjukkan status konversi.
Keterangan
Metode ini sesuai dengan metode UTF8Encoding.GetBytes , kecuali bahwa metode ini memiliki konvensi panggilan yang berbeda, mekanisme penanganan kesalahan yang berbeda, dan karakteristik performa yang berbeda.
Jika 'replaceInvalidSequences' adalah true, metode menggantikan subsekuensi source yang tidak terbentuk dengan U+FFFD di destination dan terus memproses sisa buffer. Jika tidak, metode mengembalikan OperationStatus.InvalidData jika mengalami urutan yang tidak terbentuk.
Jika metode mengembalikan kode kesalahan, parameter keluar menunjukkan berapa banyak data yang berhasil ditranskodekan, dan lokasi subsekuensi yang tidak terbentuk dapat disimpulkan dari nilai-nilai ini.
Jika 'replaceInvalidSequences' adalah true, metode tidak pernah mengembalikan OperationStatus.InvalidData. Jika 'isFinalBlock' adalah true, metode tidak pernah mengembalikan OperationStatus.NeedMoreData.