IUtf8SpanFormattable.TryFormat Methode

Definition

Versucht, den Wert der aktuellen Instanz als UTF-8 in die bereitgestellte Bytespanne zu formatieren.

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

Parameter

utf8Destination
Span<Byte>

Die Spanne, in der der Wert dieser Instanz als Bytespanne formatiert wird.

bytesWritten
Int32

Wenn diese Methode zurückgegeben wird, enthält die Anzahl der Bytes, die in utf8Destination.

format
ReadOnlySpan<Char>

Ein Bereich mit den Zeichen, die eine Standard- oder benutzerdefinierte Formatzeichenfolge darstellen, die das zulässige Format für utf8Destinationdefiniert.

provider
IFormatProvider

Ein optionales Objekt, das kulturspezifische Formatierungsinformationen für utf8Destination.

Gibt zurück

truewenn die Formatierung erfolgreich war; andernfalls . false

Hinweise

Eine Implementierung dieser Schnittstelle sollte dieselbe Zeichenfolge von Zeichen wie eine Implementierung von ToString(String, IFormatProvider) oder TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) auf demselben Typ erzeugen. TryFormat sollte nur zurückgegeben werden false , wenn nicht genügend Speicherplatz im Zielpuffer vorhanden ist. Andere Fehler sollten eine Ausnahme auslösen.

Gilt für: