IUtf8SpanFormattable.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 jako UTF-8 w podanym zakresie bajtów.
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
Parametry
Zakres, w którym ma być zapisywana wartość tego wystąpienia sformatowana jako zakres bajtów.
- bytesWritten
- Int32
Gdy ta metoda zwraca wartość , zawiera liczbę bajtów, które zostały zapisane w pliku utf8Destination
.
- format
- ReadOnlySpan<Char>
Zakres zawierający znaki reprezentujące ciąg formatu standardowego lub niestandardowego, który definiuje akceptowalny format dla elementu utf8Destination
.
- provider
- IFormatProvider
Opcjonalny obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury dla elementu utf8Destination
.
Zwraca
true
jeśli formatowanie zakończyło się pomyślnie; w przeciwnym razie , false
.
Uwagi
Implementacja tego interfejsu powinna generować ten sam ciąg znaków co implementacja ToString(String, IFormatProvider) lub TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) na tym samym typie. Funkcja TryFormat powinna zwracać false
tylko wtedy, gdy w buforze docelowym nie ma wystarczającej ilości miejsca. Wszelkie inne błędy powinny zgłaszać wyjątek.