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 -> boolPublic Function TryFormat (utf8Destination As Span(Of Byte), ByRef bytesWritten As Integer, format As ReadOnlySpan(Of Char), provider As IFormatProvider) As BooleanПараметры
Диапазон, в который записывается значение этого экземпляра в формате диапазона байтов.
- bytesWritten
- Int32
При возврате этого метода содержит количество байтов, записанных в utf8Destination.
- format
- ReadOnlySpan<Char>
Диапазон, содержащий символы, представляющие стандартную или настраиваемую строку формата, которая определяет допустимый формат для utf8Destination.
- provider
- IFormatProvider
Необязательный объект, предоставляющий сведения о форматировании с учетом определенного языка и региональных параметров для utf8Destination.
Возвращаемое значение
Значение true, если форматирование выполнено успешно; в противном случае — значение false.
Комментарии
Реализация этого интерфейса должна создавать ту же строку символов, что и реализация ToString(String, IFormatProvider) или TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) для того же типа. Функция TryFormat должна возвращать данные false только в том случае, если в буфере назначения недостаточно места; любые другие сбои должны вызывать исключение.
