ISpanFormattable.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 in die angegebene Zeichenspanne zu formatieren.
public:
bool TryFormat(Span<char> destination, [Runtime::InteropServices::Out] int % charsWritten, ReadOnlySpan<char> format, IFormatProvider ^ provider);
public bool TryFormat (Span<char> destination, out int charsWritten, ReadOnlySpan<char> format, IFormatProvider? provider);
abstract member TryFormat : Span<char> * int * ReadOnlySpan<char> * IFormatProvider -> bool
Public Function TryFormat (destination As Span(Of Char), ByRef charsWritten As Integer, format As ReadOnlySpan(Of Char), provider As IFormatProvider) As Boolean
Parameter
Die Spanne, in der der Wert dieser Instanz geschrieben werden soll, formatiert als Spanne von Zeichen.
- charsWritten
- Int32
Wenn diese Methode zurückgibt, enthält die Anzahl der Zeichen, die in destination
geschrieben wurden.
- format
- ReadOnlySpan<Char>
Eine Zeichenspanne, die eine standardmäßige oder benutzerdefinierte Formatzeichenfolge darstellt, die das akzeptable Format für destination
definiert.
- provider
- IFormatProvider
Ein optionales Objekt, das kulturspezifische Formatierungsinformationen für destination
bereitstellt.
Gibt zurück
true
, wenn die Formatierung erfolgreich war, andernfalls false
Hinweise
- Eine Implementierung dieser Schnittstelle sollte die gleiche Zeichenfolge von Zeichen wie eine Implementierung von ToString(String, IFormatProvider) für denselben Typ erzeugen.
- TryFormat sollte nur dann false zurückgeben, wenn nicht genügend Speicherplatz im Zielpuffer vorhanden ist. Alle anderen Fehler sollten eine Ausnahme auslösen.