IUtf8SpanFormattable.TryFormat Метод

Определение

Пытается отформатировать значение текущего экземпляра как UTF-8 в предоставленный диапазон байтов.

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

Параметры

utf8Destination
Span<Byte>

Диапазон, в котором записывается значение этого экземпляра, отформатированный как диапазон байтов.

bytesWritten
Int32

При возврате этого метода содержит количество байтов, записанных в utf8Destination.

format
ReadOnlySpan<Char>

Диапазон, содержащий символы, представляющие стандартную или настраиваемую строку формата, которая определяет допустимый формат.utf8Destination

provider
IFormatProvider

Необязательный объект, предоставляющий сведения о utf8Destinationформатировании для языка и региональных параметров.

Возвращаемое значение

true Значение , если форматирование выполнено успешно; falseв противном случае .

Комментарии

Реализация этого интерфейса должна создавать ту же строку символов, что и реализация ToString(String, IFormatProvider)TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) или на том же типе. TryFormat должен возвращать false только в том случае, если в буфере назначения недостаточно места; любые другие сбои должны вызывать исключение.

Применяется к