Freigeben über


ISpanFormattable.TryFormat Methode

Definition

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

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: