IUtf8SpanFormattable.TryFormat 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.
Mencoba memformat nilai instans saat ini sebagai UTF-8 ke dalam rentang byte yang disediakan.
public:
bool TryFormat(Span<System::Byte> utf8Destination, [Runtime::InteropServices::Out] int % bytesWritten, ReadOnlySpan<char> format, IFormatProvider ^ provider);
public bool TryFormat (Span<byte> utf8Destination, out int bytesWritten, ReadOnlySpan<char> format, IFormatProvider? provider);
abstract member TryFormat : Span<byte> * int * ReadOnlySpan<char> * IFormatProvider -> bool
Public Function TryFormat (utf8Destination As Span(Of Byte), ByRef bytesWritten As Integer, format As ReadOnlySpan(Of Char), provider As IFormatProvider) As Boolean
Parameter
Rentang untuk menulis nilai instans ini yang diformat sebagai rentang byte.
- bytesWritten
- Int32
Ketika metode ini kembali, berisi jumlah byte yang ditulis dalam utf8Destination
.
- format
- ReadOnlySpan<Char>
Rentang yang berisi karakter yang mewakili string format standar atau kustom yang menentukan format yang dapat diterima untuk utf8Destination
.
- provider
- IFormatProvider
Objek opsional yang memasok informasi pemformatan khusus budaya untuk utf8Destination
.
Mengembalikan
true
jika pemformatan berhasil; jika tidak, false
.
Keterangan
Implementasi antarmuka ini harus menghasilkan string karakter yang sama dengan implementasi ToString(String, IFormatProvider) atau TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) pada jenis yang sama. TryFormat harus kembali false
hanya jika tidak ada cukup ruang di buffer tujuan; kegagalan lain harus melemparkan pengecualian.