IUtf8SpanFormattable.TryFormat Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

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

utf8Destination

Span<Byte>

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

Boolean

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.