Sdílet prostřednictvím


IUtf8SpanFormattable.TryFormat Metoda

Definice

Pokusí se naformátovat hodnotu aktuální instance jako UTF-8 do zadaného rozsahu bajtů.

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>

Rozsah, ve kterém se má zapisovat hodnota této instance formátovaná jako rozpětí bajtů.

bytesWritten
Int32

Když tato metoda vrátí hodnotu , obsahuje počet bajtů, které byly zapsány v utf8Destination.

format
ReadOnlySpan<Char>

Rozsah obsahující znaky, které představují řetězec standardního nebo vlastního formátu, který definuje přijatelný formát pro utf8Destination.

provider
IFormatProvider

Volitelný objekt, který poskytuje informace o formátování specifické pro jazykovou verzi pro utf8Destination.

Návraty

truepokud bylo formátování úspěšné; v opačném případě . false

Poznámky

Implementace tohoto rozhraní by měla vytvořit stejný řetězec znaků jako implementace ToString(String, IFormatProvider) nebo TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) na stejném typu. Příkaz TryFormat by měl vrátit false pouze v případě, že v cílové vyrovnávací paměti není dostatek místa. Jakákoli jiná selhání by měla vyvolat výjimku.

Platí pro