ISpanFormattable.TryFormat Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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 destination
pliku .
- format
- ReadOnlySpan<Char>
Zakres zawierający znaki reprezentujące ciąg formatu standardowego lub niestandardowego, który definiuje akceptowalny format dla destination
elementu .
- 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.