IUtf8SpanFormattable.TryFormat Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

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

Boolean

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.