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。 任何其他失敗都應該擲回例外狀況。