ISpanFormattable.TryFormat Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

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.