IUtf8SpanFormattable.TryFormat Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

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

utf8Destination

Span<Byte>

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

Boolean

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.