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

注釈

このインターフェイスの実装では、同じ型の または TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) の実装ToString(String, IFormatProvider)と同じ文字の文字列を生成する必要があります。 TryFormat は、宛先バッファーに十分な領域がない場合にのみ を返 false す必要があります。その他のエラーでは例外がスローされます。

適用対象