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 す必要があります。その他のエラーでは例外がスローされます。