ISpanFormattable.TryFormat Metoda

Definicja

Próbuje sformatować wartość bieżącego wystąpienia w podanym zakresie znaków.

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

Parametry

destination
Span<Char>

Zakres, w którym ma być zapisywana wartość tego wystąpienia sformatowana jako zakres znaków.

charsWritten
Int32

Gdy ta metoda zwróci wartość , zawiera liczbę znaków, które zostały zapisane w destinationpliku .

format
ReadOnlySpan<Char>

Zakres zawierający znaki reprezentujące ciąg formatu standardowego lub niestandardowego, który definiuje akceptowalny format dla destinationelementu .

provider
IFormatProvider

Opcjonalny obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury dla programu destination.

Zwraca

true jeśli formatowanie zakończyło się pomyślnie; w przeciwnym razie , false.

Uwagi

  • Implementacja tego interfejsu powinna wygenerować ten sam ciąg znaków co implementacja ToString(String, IFormatProvider) tego samego typu.
  • Funkcja TryFormat powinna zwracać wartość false tylko wtedy, gdy w buforze docelowym nie ma wystarczającej ilości miejsca. Wszelkie inne błędy powinny zgłaszać wyjątek.

Dotyczy