IUtf8SpanFormattable.TryFormat 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

尝试将当前实例的值格式化为 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 的区域性特定格式设置信息。

返回

Boolean

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

注解

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