ISpanFormattable.TryFormat Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

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

destination: Span<Char>

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 destinationgeschrieben 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

Boolean

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.

Gilt für:

Produkt	Versionen
.NET	6, 7, 8, 9, 10

Teilen über