ISpanFormattable.TryFormat 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

尝试将当前实例的值格式化为提供的字符范围。

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 的区域性特定格式设置信息。

返回

Boolean

如果格式设置成功，则为 true；否则为 false。

注解

• 此接口的实现应生成与同一类型上的 实现 ToString(String, IFormatProvider) 相同的字符串。
• 仅当目标缓冲区中没有足够的空间时，TryFormat 才应返回 false。 任何其他失败都应引发异常。