英語で読む

次の方法で共有


ISpanFormattable.TryFormat メソッド

定義

現在のインスタンスの値を、指定された文字数のスパンに書式設定しようとします。

C#
public bool TryFormat(Span<char> destination, out int charsWritten, ReadOnlySpan<char> format, IFormatProvider? provider);

パラメーター

destination
Span<Char>

このインスタンスの値を文字のスパンとして書式設定して書き込むスパン。

charsWritten
Int32

このメソッドが戻るときに、 に書 destinationき込まれた文字数を格納します。

format
ReadOnlySpan<Char>

destination に許容される書式を定義する、標準またはカスタムの書式指定文字列を表す文字を格納しているスパン。

provider
IFormatProvider

destination のカルチャ固有の書式情報を指定する省略可能なオブジェクト。

戻り値

書式設定が正常に実行された場合は true。それ以外の場合は false

注釈

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

適用対象

製品 バージョン
.NET 6, 7, 8, 9, 10