IUtf8SpanFormattable.TryFormat Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

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

Boolean

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.