Поделиться через


ISpanFormattable.TryFormat Метод

Определение

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

public:
 bool TryFormat(Span<char> destination, [Runtime::InteropServices::Out] int % charsWritten, ReadOnlySpan<char> format, IFormatProvider ^ provider);
public bool TryFormat (Span<char> destination, out int charsWritten, ReadOnlySpan<char> format, IFormatProvider? provider);
abstract member TryFormat : Span<char> * int * ReadOnlySpan<char> * IFormatProvider -> bool
Public Function TryFormat (destination As Span(Of Char), ByRef charsWritten As Integer, format As ReadOnlySpan(Of Char), provider As IFormatProvider) As Boolean

Параметры

destination
Span<Char>

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

charsWritten
Int32

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

format
ReadOnlySpan<Char>

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

provider
IFormatProvider

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

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

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

Комментарии

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

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