Partager via


IUtf8SpanFormattable.TryFormat Méthode

Définition

Tente de mettre en forme la valeur de la instance actuelle en UTF-8 dans l’étendue d’octets fournie.

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

Paramètres

utf8Destination
Span<Byte>

Étendue dans laquelle écrire la valeur de ce instance mise en forme sous forme d’une étendue d’octets.

bytesWritten
Int32

Lorsque cette méthode est retournée, contient le nombre d’octets qui ont été écrits dans utf8Destination.

format
ReadOnlySpan<Char>

Plage contenant les caractères qui représentent une chaîne de format standard ou personnalisée qui définit le format acceptable pour utf8Destination.

provider
IFormatProvider

Objet facultatif qui fournit des informations de mise en forme propres à la culture pour utf8Destination.

Retours

true si la mise en forme a été effectuée, sinon, false.

Remarques

Une implémentation de cette interface doit produire la même chaîne de caractères qu’une implémentation de ToString(String, IFormatProvider) ou TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) sur le même type. TryFormat ne doit retourner false que s’il n’y a pas suffisamment d’espace dans la mémoire tampon de destination ; tout autre échec doit lever une exception.

S’applique à