ISpanFormattable.TryFormat Methode

Definition

Versucht, den Wert der aktuellen Instanz in die bereitgestellte 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 als Bereich von Zeichen formatiert wird.

charsWritten
Int32

Wenn diese Methode zurückgegeben wird, enthält die Anzahl der Zeichen, in destinationdie geschrieben wurde.

format
ReadOnlySpan<Char>

Ein Bereich mit den Zeichen, die eine Standard- oder benutzerdefinierte Formatzeichenfolge darstellen, die das zulässige Format für destinationdefiniert.

provider
IFormatProvider

Ein optionales Objekt, das kulturspezifische Formatierungsinformationen für destination.

Gibt zurück

truewenn die Formatierung erfolgreich war; andernfalls . false

Hinweise

  • Eine Implementierung dieser Schnittstelle sollte dieselbe Zeichenzeichenfolge wie eine Implementierung desselben ToString(String, IFormatProvider) Typs erzeugen.
  • TryFormat sollte "false" nur zurückgeben, wenn nicht genügend Speicherplatz im Zielpuffer vorhanden ist. Alle anderen Fehler sollten eine Ausnahme auslösen.

Gilt für: