IUtf8SpanFormattable.TryFormat Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.