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 des aktuellen instance als UTF-8 in die angegebene Bytesspanne 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 dieser instance wert geschrieben werden soll, der als Bytesspanne formatiert ist.
- bytesWritten
- Int32
Wenn diese Methode zurückgibt, enthält die Anzahl der Bytes, die in utf8Destination
geschrieben wurden.
- format
- ReadOnlySpan<Char>
Eine Zeichenspanne, die eine standardmäßige oder benutzerdefinierte Formatzeichenfolge darstellt, die das akzeptable Format für utf8Destination
definiert.
- provider
- IFormatProvider
Ein optionales Objekt, das kulturspezifische Formatierungsinformationen für utf8Destination
bereitstellt.
Gibt zurück
true
, wenn die Formatierung erfolgreich war, andernfalls false
Hinweise
Eine Implementierung dieser Schnittstelle sollte dieselbe Zeichenzeichenfolge wie eine Implementierung von ToString(String, IFormatProvider) oder TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) für denselben Typ erzeugen. TryFormat sollte nur zurückgegeben false
werden, wenn nicht genügend Speicherplatz im Zielpuffer vorhanden ist. Bei anderen Fehlern sollte eine Ausnahme ausgelöst werden.