Freigeben über


IUtf8SpanFormattable.TryFormat Methode

Definition

Versucht, den Wert des aktuellen instance als UTF-8 in die angegebene Bytesspanne zu formatieren.

public:
 bool TryFormat(Span<System::Byte> utf8Destination, [Runtime::InteropServices::Out] int % bytesWritten, ReadOnlySpan<char> format, IFormatProvider ^ provider);
public bool TryFormat (Span<byte> utf8Destination, out int bytesWritten, ReadOnlySpan<char> format, IFormatProvider? provider);
abstract member TryFormat : Span<byte> * int * ReadOnlySpan<char> * IFormatProvider -> bool
Public Function TryFormat (utf8Destination As Span(Of Byte), ByRef bytesWritten As Integer, format As ReadOnlySpan(Of Char), provider As IFormatProvider) As Boolean

Parameter

utf8Destination
Span<Byte>

Die Spanne, in der dieser instance wert geschrieben werden soll, der als Bytesspanne formatiert ist.

bytesWritten
Int32

Wenn diese Methode zurückgibt, enthält die Anzahl der Bytes, die in utf8Destinationgeschrieben wurden.

format
ReadOnlySpan<Char>

Eine Zeichenspanne, die eine standardmäßige oder benutzerdefinierte Formatzeichenfolge darstellt, die das akzeptable Format für utf8Destination definiert.

provider
IFormatProvider

Ein optionales Objekt, das kulturspezifische Formatierungsinformationen für utf8Destination bereitstellt.

Gibt zurück

true, wenn die Formatierung erfolgreich war, andernfalls false

Hinweise

Eine Implementierung dieser Schnittstelle sollte dieselbe Zeichenzeichenfolge wie eine Implementierung von ToString(String, IFormatProvider) oder TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) für denselben Typ erzeugen. TryFormat sollte nur zurückgegeben false werden, wenn nicht genügend Speicherplatz im Zielpuffer vorhanden ist. Bei anderen Fehlern sollte eine Ausnahme ausgelöst werden.

Gilt für: